create-11tech-helpdesk

Scaffold a new 11TECH helpdesk project from helpdesk-starter.

Usage

npx create-11tech-helpdesk my-helpdesk

The interactive flow asks 5 questions, then scaffolds the monorepo, installs deps, starts Docker, migrates the DB, and seeds a demo tenant.

Flags

| Flag | Default | Purpose | |---|---|---| | --yes, -y | — | Accept all defaults; requires positional name or --target | | --target <dir> | ./<name> | Target directory | | --locale <code> | pt-BR | pt-BR or en-US | | --ai <choice> | stub | stub / adapt11 / seia11 | | --storage <choice> | local | local / r2 | | --no-git | run | Skip git init | | --no-install | run | Skip pnpm install | | --no-docker | run | Skip docker compose up | | --no-migrate | run | Skip Prisma migrate | | --no-seed | run | Skip Prisma seed | | --version | — | Print CLI version | | --help | — | Show usage |

Architecture

• Templates are real workspace members of helpdesk-starter (CI-typechecked).
• The CLI ships with two embedded sources for @helpdesk/* packages: templates/packages/ (published mode) and a fallback to <repo-root>/packages/ (dev mode).
• scripts/prepublish.ts snapshots starter packages into templates/packages/ before npm publish. The prepublishOnly lifecycle hook invokes it.

Dev workflow

# 1. Build
pnpm build

# 2. Run from source
node dist/index.js my-helpdesk --yes --target=/tmp/test

# 3. Run unit + integration + e2e tests
pnpm test
pnpm test:integration
pnpm test:e2e

# 4. Publish (tag triggers GitHub Action)
git tag create-helpdesk-v0.1.0
git push origin create-helpdesk-v0.1.0

Acceptance criteria

See the Phase 17 spec §11.