@creatorem/cli
v1.0.7
Published
CLI tool for the Creatorem SaaS Kit
Readme
Creatorem CLI
@creatorem/cli is the automation layer for shaping Creatorem projects fast.
It can:
- scaffold a full monorepo from template (
create) - add or edit a dashboard app (
create-dashboard) - add or edit a mobile app (
create-mobile) - strip unused features cleanly across app + repo scope
- generate schemas and migrations from setup/schema folders (
generate-sql)
Why this CLI is powerful
- Feature-driven architecture control: keep only the modules you want.
- Deep cleanup: not just UI toggles; removes imports, routes, config, files, package deps, and (optionally) repo-level kit/supabase assets.
- Template auto-selection: automatically uses premium template when access exists, otherwise OSS.
- Multi-app orchestration: in one flow you can decide marketing/dashboard/mobile/example composition.
- Language bootstrap: manages locales and language config files.
- Machine-readable metadata: writes selection manifests to
.creatorem/.
Commands
creatorem create
creatorem create-dashboard <name>
creatorem create-mobile <name>
creatorem generate-sql [mode] [args]
creatorem generate-migration [args] # alias
creatorem generate-schemas [args] # alias
creatorem helpKey options
These are primarily relevant for create-dashboard and create-mobile:
--features <comma-separated-keys>: keep only these feature keys--edit: edit the current app in place (inside existing monorepo)--repo-scope: also remove repo-level feature assets (kit/*, supabase schemas, workspace deps)
Examples:
creatorem create-dashboard my-dashboard --features ai,keybindings
creatorem create-dashboard --edit --features ai,analytics,monitoring --repo-scope
creatorem create-mobile my-mobile --features organization,onboarding
creatorem create-mobile --edit --features notification --repo-scopeSelectable features
Dashboard (create-dashboard)
Feature keys accepted by --features:
organizationkeybindingsanalyticsmonitoringainotificationbillingcontent-typeonboardingemail-templatesemailer
What each feature includes:
organization: org/member/role management and org-aware hooks/componentskeybindings: keyboard shortcut model + settings UI + hooksanalytics: Google Analytics / Umami integrationmonitoring: Sentry instrumentation integrationai: AI chat UI, tools integration, usage/wallet trackingnotification: notification UI + DB router integrationbilling: Stripe/Lemon Squeezy + billing settings + wallet/subscription flowscontent-type: premade table-oriented UI + command/search helpersonboarding: post-signup onboarding flowemail-templates: React Email templates moduleemailer: transactional email providers (Nodemailer, Postmark, Resend, Sendgrid)
Mobile (create-mobile)
Feature keys accepted by --features:
organizationnotificationonboarding
What each feature includes:
organization: org/member/role management + org hooksnotification: mobile notification UI + related backend router wiringonboarding: post-signup onboarding flow for mobile
Customization matrix
create (full monorepo wizard)
You can customize:
- project name
- git initialization
- include/exclude apps: marketing, dashboard, mobile
- per-app feature sets (dashboard + mobile)
- include example apps (detected from template repo)
- language set:
- English always included
- French selectable by default
- extra custom language codes (comma-separated)
It also:
- updates locale directories from
entemplates - updates
packages/shared/src/config/defined-languages.ts - updates mobile i18n config based on selected languages/features
- writes root manifest at
.creatorem/monorepo.json
create-dashboard / create-mobile
Modes:
- inside existing monorepo: copies from
apps/dashboardorapps/mobile, or edits in place with--edit - outside monorepo: clones template, keeps relevant apps, applies cleanup, and outputs a trimmed monorepo
Additional behavior:
- generates
.env.template(and.envwhen appropriate) from appenvs.ts - writes app-level manifest
.creatorem/features.json - with
--repo-scope, also removes repo-level feature assets and uninstalls related workspace dependencies
SQL generators
generate-sql
- Modes:
schemas(generate-sql schemas [input] [output])migration(generate-sql migration [setupInput], default mode)
- Schemas mode input:
- JSON string, or
- path to
setup.json, or - directory containing
setup.json(default:.creatorem)
- Schemas mode output directory:
- default:
supabase/app-schemas - optional second arg for custom output path
- default:
- Schemas mode also copies extra SQL files from
<inputDir>/schemaswhen present
Migration output (default generate-sql mode)
- Combines SQL from:
supabase/schemassupabase/app-schemas
- Produces:
supabase/migrations/<timestamp>_generated_from_schemas.sql
- Replaces previous generated migration files with fresh output.
