https://github.com/zitadel/nextgen
A Zitadel Preview
https://github.com/zitadel/nextgen
Last synced: 5 days ago
JSON representation
A Zitadel Preview
- Host: GitHub
- URL: https://github.com/zitadel/nextgen
- Owner: zitadel
- License: agpl-3.0
- Created: 2026-04-17T10:06:56.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-07-23T09:56:07.000Z (8 days ago)
- Last Synced: 2026-07-23T10:09:38.608Z (8 days ago)
- Language: TypeScript
- Homepage: https://zitadel-next-docs.vercel.app/docs
- Size: 8.06 MB
- Stars: 16
- Watchers: 1
- Forks: 1
- Open Issues: 99
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Zitadel — next generation
The next generation of the Zitadel identity platform, built for developers
and AI agents alike: registration and login live in your app, under your
brand, while Zitadel guards the credentials, sessions, and tokens underneath.
> **Preview status:** This work rebuilds Zitadel's storage core and API
> surface, so it ships as a preview in its own repository and is intended to
> merge back into [zitadel/zitadel](https://github.com/zitadel/zitadel) as the
> foundation of a future major version. APIs, CLI flags, package surfaces, and
> docs are still in flux; create-first, claim-later is the product direction,
> but `zitadel claim` is not shipped in this repo yet. The full story is in
> [VISION.md](VISION.md).
## Workflow front doors
### I am contributing to Zitadel
See [CONTRIBUTING.md](CONTRIBUTING.md) for contributor setup (including the
devcontainer), Moon commands, local checks, integration tests, source builds,
and release workflows. Agent-facing workspace rules live in
[AGENTS.md](AGENTS.md).
### I am adding Zitadel to my app
| I want to... | Run |
| --------------------------------- | -------------------------------------------------------------- |
| Check local runtime prerequisites | `npx @zitadel/cli@alpha doctor` |
| Start local Zitadel | `npx @zitadel/cli@alpha start` |
| Add auth to my app | `npx @zitadel/cli@alpha setup --server local` |
| Check generated app files | `npx @zitadel/cli@alpha doctor` |
| Stop local Zitadel, keeping data | `npx @zitadel/cli@alpha stop` |
| Delete local Zitadel data | `npx @zitadel/cli@alpha reset --force` |
The published `zitadel` runtime commands run the released local runtime through
the `@zitadel/server` npm binary by default and do not require Docker, Go, Moon,
or a source checkout. Docker remains available with
`zitadel start --runtime docker`.
### I am an agent (or driving one)
The CLI is the agent-facing surface today: every command supports
`--non-interactive --json` and returns a structured envelope.
[apps/cli/SKILLS.md](apps/cli/SKILLS.md) is the canonical contract for agents
integrating Zitadel into an app; [AGENTS.md](AGENTS.md) is for agents
contributing to this repository. The documentation site publishes LLM-friendly
text at `/llms.txt`, `/llms-full.txt`, and page-level `.md` URLs.
## Customer quick start
```sh
mkdir myapp
cd myapp
npx @zitadel/cli@alpha doctor
npx @zitadel/cli@alpha start
npx @zitadel/cli@alpha setup --server local
npm run dev
```
Open http://localhost:3000/login and register your first local user. The
managed Zitadel runtime stores its metadata and data under
`.zitadel/local/`; `stop` preserves that data and `reset --force`
deletes it. In a fresh directory, `setup` walks through the scaffold choices
(such as which framework and use case) and writes the app into the current
directory. It installs dependencies with the detected package manager; pass
`--skip-install` if you want to install them yourself.
## Manual Docker quick start
Run the API and embedded UIs with Docker Compose when you want to inspect the
operator-style stack directly:
```sh
cd docs/operations
cp env.example .env
docker compose up -d
```
| Surface | URL |
| ------------------ | --------------------------------- |
| Management console | http://localhost:8080/ui/console/ |
| Sign-in shell | http://localhost:8080/ui/login/ |
| Health | http://localhost:8080/healthz |
Details: [docs/quick-start/index.md](docs/quick-start/index.md). To build from source: [CONTRIBUTING.md](CONTRIBUTING.md).
## Documentation site
The Fumapress/Fumadocs documentation skeleton lives in `apps/docs`.
```sh
moon run docs:dev
moon run docs:build
```
The docs app bundles the OpenAPI source into a generated reference, exposes
static search, and publishes LLM-friendly text at `/llms.txt`,
`/llms-full.txt`, page-level `.md` URLs, and `/mcp`.
## Current status
This repository is pre-release. The Go `server` command serves the OpenAPI
surface and embeds the console and login UIs at `/ui/console/` and `/ui/login/`.
CI produces installable snapshots for review, not official releases.
For product direction and the four pillars, see [VISION.md](VISION.md).
## CI
Pull requests are gated by the GitHub Actions context `full-pr`, shown in the
pull request UI as `ci / full-pr`. On a 16-core runner it runs a Go
generated-file drift check, lint, type checks, builds, unit and browser
tests, Go tests including Postgres integration, a non-publishing release
snapshot, and fresh-app journeys against the snapshot's npm tarballs.
Changesets version PRs run a smaller release validation path instead, and
Changesets comments give release-intent feedback without adding a blocking
gate. The full step list lives in
[`.github/workflows/ci.yml`](.github/workflows/ci.yml) and
[CONTRIBUTING.md](CONTRIBUTING.md#what-ci-runs).
## Releases
Moon builds the artifacts (Go binaries, containers, archives) and the draft
GitHub Release; Changesets owns versions, npm publishing, and release notes,
with the public packages on one fixed alpha train. Build a local snapshot with
`moon run release:snapshot` (more in [CONTRIBUTING.md](CONTRIBUTING.md)). To
cut or recover a release, follow the
[release runbook](docs/runbooks/manual-release.md); for when to add a
changeset, see [`.changeset/README.md`](.changeset/README.md); for the
rationale, see [ADR 002](docs/adrs/002-multi-package-release-strategy.md).