@021.is/spine

@021.is/spine

CLI for scaffolding 021-shaped projects and auditing existing ones.

Install

bun add -g @021.is/spine
# or
npx @021.is/spine ...

Commands

spine new <name>

Scaffold a fresh Next.js app following the Spine folder doctrine. Creates 19 files: full feature-folder skeleton + one example feature + Vitest/Playwright config + Prisma stub + Biome config + AGENTS.md + CLAUDE.md.

spine new my-app
cd my-app
bun install
bun run test

spine doctor

Audit an existing repo against STRUCTURE.md. Lists every error + warning + actionable hint.

spine doctor
# Type: next-app
# ✗ [no-vitest] vitest not installed.
#     → bun add -d vitest @vitest/coverage-v8
# ✗ [missing-spine-errors] @021.is/spine-errors not installed.
#     → Required across every product. Run: bun add @021.is/spine-errors
# ...

Exit code 1 on any error. Use as a pre-merge sanity check or in CI.

Roadmap (not yet shipped)

These ideas live as GitHub issues; the CLI currently only ships new + doctor. PRs welcome.

• spine add feature <name> — scaffold a feature folder skeleton inside an existing repo
• spine add testing / spine add auth — install a Spine package + wire boilerplate
• spine upgrade — bump all @021.is/spine-* to latest in lockstep