What It Does
@creatorem/cli scaffolds and refactors monorepos using app + feature selection. It can also generate SQL artifacts from .creatorem/setup.json inputs.
When To Use
- Starting a new customer project.
- Removing unused features from an existing repo.
- Generating SQL schemas/migrations after setup changes.
Prerequisites
gitavailable in PATH.pnpmworkspace environment.- Run from monorepo root for
generate-sqlcommands.
Important
This page describes the standard kit integration path; adapt app-specific paths and config names when your project differs.
How To Use
Core commands
Important options
--features: comma-separated feature keys to keep.--edit: mutate current app in place.--repo-scope: also remove repo-level assets/dependencies for deselected features.--oss: force OSS template source.
Selectable apps
| App | Description |
|---|---|
| Dashboard | Main SaaS dashboard (Next.js) |
| Marketing | Landing / marketing website (Next.js) |
| Mobile | React Native app (Expo) |
| API | Standalone API server |
| Examples | Optional real-case example apps from examples/* to bootstrap from concrete implementations |
Selectable features
Features are selected per app. Each one toggles UI components, database schemas, and kit packages.
Dashboard
| Key | What it adds |
|---|---|
analytics | Google Analytics and Umami support |
monitoring | Sentry integration |
ai | AI chat UI, tools, AI wallet and usage tracking |
organization | Teams, roles, member management, <OrganizationSwitcher /> |
notification | Notification UI and database logic |
billing | Stripe and Lemon Squeezy, subscriptions, one-time payments, credit wallet |
content-type | Premade data-display components, search helpers, edit forms |
keybindings | Keyboard shortcut settings UI and React hooks |
onboarding | Post-signup information collection |
email-templates | React Email templates for auth and transactional emails |
emailer | Email sending via Nodemailer, Postmark, Resend, or Sendgrid |
Mobile
| Key | What it adds |
|---|---|
organization | Teams, roles, member management (React Native) |
notification | Notification UI and database logic (React Native) |
onboarding | Post-signup information collection |
Selectable examples
If the source repository contains an examples/ directory, the wizard can include one or more examples in the generated project.
SQL generation behavior
generate-schemas: createssupabase/app-schemas/*.sql.generate-migration: mergessupabase/schemas+supabase/app-schemasintosupabase/migrations/<timestamp>_generated_from_schemas.sql.generate-sqldefaults to migration mode.
MCP Context
capability: project_generation_and_refactor entrypoints: - cli/src/cli.tsx - cli/src/commands/create*.tsx - cli/src/commands/generate-*.mjs inputs: - app_selection - feature_selection - setup_reference outputs: - generated_or_trimmed_monorepo - generated_sql_artifacts constraints: - feature keys must match command-specific feature registries - SQL generation expects supabase directory structure side_effects: - creates/deletes files - updates workspace deps and manifests
Agent Recipe
- For new projects, run
createand choose apps/features interactively. - For existing repos, use
create-dashboard --editorcreate-mobile --editwith explicit--features. - After schema/setup edits, run
creatorem generate-sqlfrom root.
Troubleshooting
- If
generate-sqlcannot find setup input, pass explicit path:creatorem generate-schemas apps/<app>/.creatorem/setup.json. - If repo cleanup is incomplete, rerun with
--repo-scope.
Related
Benefits
Why this codebase exists and what it optimizes for.
MCP Server
Installable bridge that lets coding agents query Creatorem docs capabilities and page content.
How is this guide?
Last updated on 3/23/2026