CLI & management commands¶

Conjure adds a few Django management commands (backend) and a scaffolding CLI (frontend).

Management commands¶

`migrate conjure`¶

✅ Standard Django migration that creates the single AdminAuditLog table. Run once after install.

python manage.py migrate conjure

CRUD, schema, and widgets all work before this runs — only audit writes are skipped until the table exists.

`conjure_dump_schema`¶

✅ Dumps the introspection schema of every registered model to the snapshot file the frontend codegen reads.

python manage.py conjure_dump_schema > schema-snapshot.json   # feed it to the scaffolder

Re-run it whenever you add a model or change fields, then regenerate the affected pages.

`sync_admin_actions`¶

📋 Idempotently creates the Permission rows for every declared action — no migration. Run on deploy and whenever you add an action.

python manage.py sync_admin_actions

See Actions & permissions.

Frontend scaffolder¶

`@terracelab/conjure-web init`¶

✅ Scaffolds the React dashboard into your project for codegen mode, wires in your schema snapshot, and runs codegen. The output is a Vite + React app you own.

python manage.py conjure_dump_schema > schema-snapshot.json
npx @terracelab/conjure-web init conjure-admin    # picks up ./schema-snapshot.json

Options: --snapshot <path>, --manifest <path>, --no-codegen, --force.

Codegen assembly¶

✅ Rebuilds the router and sidebar from the page manifest after you add or move pages.

python codegen/assemble.py   # regenerates router.tsx + sidebar-nav.ts + sections.ts

See Sections & tabs.

npm scripts (codegen mode)¶

Command	Purpose
`npm run dev`	Vite dev server (proxies `/conjure` to your backend).
`npm run build`	Production build (`tsc` strict + Vite).
`npm run typecheck`	Type-check without emitting.

Cheat sheet¶

# Backend
python manage.py migrate conjure          # audit log table (once)
python manage.py conjure_dump_schema      # refresh schema snapshot
python manage.py sync_admin_actions       # create action permissions 📋
python manage.py test conjure             # run the package tests

# Frontend (codegen mode)
npm run dev / npm run build / npm run typecheck
python codegen/assemble.py                # rebuild router + sidebar

Generated from --help (planned)

📋 A future generator (gen/gen_cli.py) will capture each command's --help output so this reference is generated from the code. See the generators README.