{"id":51900426,"url":"https://github.com/zitadel/nextgen","last_synced_at":"2026-07-26T14:03:56.871Z","repository":{"id":370293663,"uuid":"1213375111","full_name":"zitadel/nextgen","owner":"zitadel","description":"A Zitadel Preview","archived":false,"fork":false,"pushed_at":"2026-07-23T09:56:07.000Z","size":8456,"stargazers_count":16,"open_issues_count":99,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-23T10:09:38.608Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://zitadel-next-docs.vercel.app/docs","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zitadel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-17T10:06:56.000Z","updated_at":"2026-07-23T09:24:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zitadel/nextgen","commit_stats":null,"previous_names":["zitadel/nextgen"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/zitadel/nextgen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fnextgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fnextgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fnextgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fnextgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zitadel","download_url":"https://codeload.github.com/zitadel/nextgen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fnextgen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35916664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-26T02:00:06.503Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-26T14:03:56.053Z","updated_at":"2026-07-26T14:03:56.864Z","avatar_url":"https://github.com/zitadel.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zitadel — next generation\n\nThe next generation of the Zitadel identity platform, built for developers\nand AI agents alike: registration and login live in your app, under your\nbrand, while Zitadel guards the credentials, sessions, and tokens underneath.\n\n\u003e **Preview status:** This work rebuilds Zitadel's storage core and API\n\u003e surface, so it ships as a preview in its own repository and is intended to\n\u003e merge back into [zitadel/zitadel](https://github.com/zitadel/zitadel) as the\n\u003e foundation of a future major version. APIs, CLI flags, package surfaces, and\n\u003e docs are still in flux; create-first, claim-later is the product direction,\n\u003e but `zitadel claim` is not shipped in this repo yet. The full story is in\n\u003e [VISION.md](VISION.md).\n\n## Workflow front doors\n\n### I am contributing to Zitadel\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contributor setup (including the\ndevcontainer), Moon commands, local checks, integration tests, source builds,\nand release workflows. Agent-facing workspace rules live in\n[AGENTS.md](AGENTS.md).\n\n### I am adding Zitadel to my app\n\n| I want to...                      | Run                                                            |\n| --------------------------------- | -------------------------------------------------------------- |\n| Check local runtime prerequisites | `npx @zitadel/cli@alpha doctor`                                |\n| Start local Zitadel               | `npx @zitadel/cli@alpha start`                                 |\n| Add auth to my app                | `npx @zitadel/cli@alpha setup --server local`                  |\n| Check generated app files         | `npx @zitadel/cli@alpha doctor`                                |\n| Stop local Zitadel, keeping data  | `npx @zitadel/cli@alpha stop`                                  |\n| Delete local Zitadel data         | `npx @zitadel/cli@alpha reset --force`                         |\n\nThe published `zitadel` runtime commands run the released local runtime through\nthe `@zitadel/server` npm binary by default and do not require Docker, Go, Moon,\nor a source checkout. Docker remains available with\n`zitadel start --runtime docker`.\n\n### I am an agent (or driving one)\n\nThe CLI is the agent-facing surface today: every command supports\n`--non-interactive --json` and returns a structured envelope.\n[apps/cli/SKILLS.md](apps/cli/SKILLS.md) is the canonical contract for agents\nintegrating Zitadel into an app; [AGENTS.md](AGENTS.md) is for agents\ncontributing to this repository. The documentation site publishes LLM-friendly\ntext at `/llms.txt`, `/llms-full.txt`, and page-level `.md` URLs.\n\n## Customer quick start\n\n```sh\nmkdir myapp\ncd myapp\nnpx @zitadel/cli@alpha doctor\nnpx @zitadel/cli@alpha start\nnpx @zitadel/cli@alpha setup --server local\nnpm run dev\n```\n\nOpen http://localhost:3000/login and register your first local user. The\nmanaged Zitadel runtime stores its metadata and data under\n`.zitadel/local/`; `stop` preserves that data and `reset --force`\ndeletes it. In a fresh directory, `setup` walks through the scaffold choices\n(such as which framework and use case) and writes the app into the current\ndirectory. It installs dependencies with the detected package manager; pass\n`--skip-install` if you want to install them yourself.\n\n## Manual Docker quick start\n\nRun the API and embedded UIs with Docker Compose when you want to inspect the\noperator-style stack directly:\n\n```sh\ncd docs/operations\ncp env.example .env\ndocker compose up -d\n```\n\n| Surface            | URL                               |\n| ------------------ | --------------------------------- |\n| Management console | http://localhost:8080/ui/console/ |\n| Sign-in shell      | http://localhost:8080/ui/login/   |\n| Health             | http://localhost:8080/healthz     |\n\nDetails: [docs/quick-start/index.md](docs/quick-start/index.md). To build from source: [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Documentation site\n\nThe Fumapress/Fumadocs documentation skeleton lives in `apps/docs`.\n\n```sh\nmoon run docs:dev\nmoon run docs:build\n```\n\nThe docs app bundles the OpenAPI source into a generated reference, exposes\nstatic search, and publishes LLM-friendly text at `/llms.txt`,\n`/llms-full.txt`, page-level `.md` URLs, and `/mcp`.\n\n## Current status\n\nThis repository is pre-release. The Go `server` command serves the OpenAPI\nsurface and embeds the console and login UIs at `/ui/console/` and `/ui/login/`.\nCI produces installable snapshots for review, not official releases.\n\nFor product direction and the four pillars, see [VISION.md](VISION.md).\n\n## CI\n\nPull requests are gated by the GitHub Actions context `full-pr`, shown in the\npull request UI as `ci / full-pr`. On a 16-core runner it runs a Go\ngenerated-file drift check, lint, type checks, builds, unit and browser\ntests, Go tests including Postgres integration, a non-publishing release\nsnapshot, and fresh-app journeys against the snapshot's npm tarballs.\nChangesets version PRs run a smaller release validation path instead, and\nChangesets comments give release-intent feedback without adding a blocking\ngate. The full step list lives in\n[`.github/workflows/ci.yml`](.github/workflows/ci.yml) and\n[CONTRIBUTING.md](CONTRIBUTING.md#what-ci-runs).\n\n## Releases\n\nMoon builds the artifacts (Go binaries, containers, archives) and the draft\nGitHub Release; Changesets owns versions, npm publishing, and release notes,\nwith the public packages on one fixed alpha train. Build a local snapshot with\n`moon run release:snapshot` (more in [CONTRIBUTING.md](CONTRIBUTING.md)). To\ncut or recover a release, follow the\n[release runbook](docs/runbooks/manual-release.md); for when to add a\nchangeset, see [`.changeset/README.md`](.changeset/README.md); for the\nrationale, see [ADR 002](docs/adrs/002-multi-package-release-strategy.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitadel%2Fnextgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzitadel%2Fnextgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitadel%2Fnextgen/lists"}