ZitPlane

Compact, developer-friendly monorepo for a central identity service, a branded login frontend and an independent user self-service account portal.

Current phase status

  • P01 Foundation: complete, initial commit 8f54ccb.
  • P02 ZITADEL local backend: pinned official images, development Compose and secure local bootstrap helper source prepared. Docker startup and Admin Console integration remain unverified; all follow-up local testing is explicitly deferred to a future Gitea Actions scope.
  • P03 Login V2 source: official v4.20.4 source and matching client/proto workspace imported under auth/ui/v2/; no redesign or runtime build/test was performed. CI validation remains pending.
  • P04 Account Portal: not started.
  • Production / Coolify: not configured or deployed.

Responsibility map

Path Purpose
core/backend/zitadel/ Official ZITADEL backend integration and local helper
deployment/docker/compose.backend.dev.yaml Loopback-only developer stack
auth/ui/v2/ Official Login V2 monorepo subset (Next.js source in apps/login/, matched client/proto and pnpm/Nx workspace)
users/ui/ Future account self-service portal (P04)
packages/ Shared packages only when needed
tests/ Focused contracts and future integration/UI tests
docs/ Architecture, scopes and developer instructions

Local development (requires Docker Desktop Linux containers)

py core/backend/zitadel/dev.py init
py core/backend/zitadel/dev.py config
py core/backend/zitadel/dev.py up

When the backend stack is actually running, the local Admin Console is expected at http://localhost:8080/ui/console. This is not a currently verified working URL. See backend setup and developer guide.

Intended public architecture (not deployed)

  • auth.vib.tools: eventual ZITADEL API, official Console, customized login.
  • account.vib.tools: future custom account portal.
  • Individual SaaS applications own their own billing, subscriptions and business databases.
  • One Git repo, isolated containers; ZITADEL Go source remains upstream.

Working agreements

Read AGENTS.md, architecture, P03 source import, Login V2 workspace guide and phase scopes. Use separate, expressly approved phases; no production secrets or user data in Git.

S
Description
Unified Auth & Accounts Control Plane powered by ZITADEL. Features a compact React + Tailwind UI, custom domain routing, and multi-app SSO for modern SaaS ecosystems.
Readme
4.4 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 91.7%
JavaScript 2.6%
Go 1.9%
Python 1.8%
Shell 1.3%
Other 0.4%