create-ab-app
v0.1.1
Published
Scaffold a React + Vite app with ab-ecosystem-sso auth and billing already wired up.
Maintainers
Readme
create-ab-app
Scaffold a React + Vite app with authentication and billing already wired up via
ab-ecosystem-sso.
npm create ab-app@latest my-app◇ Where should the project be created? my-app
◇ App display name My App
◇ Auth project id 459412-review-ai.abprojects.com
◇ Auth API base URL https://partner-api.example.com
◇ Your own API base URL (optional)
◇ Start with the in-app documentation? Yes
◇ Package manager npm
◇ Install dependencies now? Yes
◇ Initialise a git repository? YesYou get React 19, TypeScript, Tailwind v4, shadcn/ui with the sidebar-07 shell,
login / signup / 2FA / magic links / password reset / email verification, plans,
wallets, credits, route guards, entitlement gating, toasts and a theme toggle.
Options
Every prompt has a flag, so CI can scaffold non-interactively:
npx create-ab-app my-app \
--project-id=459412-review-ai.abprojects.com \
--auth-url=https://partner-api.example.com \
--app-name="Review AI" \
--minimal --no-install --no-git -y| Flag | Effect |
| --- | --- |
| --project-id=<id> | VITE_AUTH_PROJECT_ID (required) |
| --auth-url=<url> | VITE_AUTH_API_BASE_URL |
| --api-url=<url> | VITE_API_BASE_URL — your own backend |
| --app-name=<name> | Sidebar and browser-tab name |
| --minimal | Skip the in-app documentation pages |
| --pm=<npm\|pnpm\|yarn\|bun> | Package manager |
| --no-install / --no-git | Skip those steps |
| -y, --yes | Accept defaults for everything optional |
After scaffolding
cd my-app
npm run devSign in and the sidebar carries the documentation: project structure, auth,
billing, routing, theming, and calling your own API. The one rule it opens with:
import from @/lib/sso, never from ab-ecosystem-sso directly.
Requires Node 20+.
