Files
agentic-dev/docs/guides/scaffolding-core-package.md
Danijel Martinek f77e6ea881 chore(template): clean-slate template snapshot from bb4a0c7
Curated, product-agnostic snapshot of the post-story-04 tree: demo
content deleted, auth-only reference feature, web-next shell, all gates
green. Product-specific docs, ADRs 027-029, PRDs/epics/archive, editor
library traces, and product naming are curated out; generic template
repairs (coverage provider devDeps, root test:coverage script, live
lint fixes, root-only release-please) are kept. See TEMPLATE.md for
provenance, curation list, and usage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK
2026-07-12 20:40:54 +02:00

1.6 KiB
Raw Blame History

Core-package generator

pnpm turbo gen core-package scaffolds an optional core package back into a slimmed template. Each name maps to a verbatim copy of the package as it shipped at the time the generator was added.

Usage

pnpm turbo gen core-package
# → Which optional core package? (use arrow keys)
#    realtime
#     events
#     trpc
#     ui

The generator emits the package files, updates consuming-app config (e.g. apps/web-next/next.config.mjs transpilePackages), patches packages/core-eslint/base.js to re-add any package-specific lint rules, then prints the manual app/server wiring needed to bring the package fully online.

Available templates

Name Description
realtime Socket.IO realtime layer (ADR-016)
events Cross-feature event bus + Payload jobs adapter (ADR-015)
trpc tRPC server setup
ui Design-system package
audit DPA-compliant audit logging (ADR-018)

Verifying an existing project

If your project already has a core-* package and you want to verify the generator's template hasn't drifted from the shipped source, use the byte-identical reconstruction snapshot:

git stash -u
pnpm turbo gen core-package <name>
git diff packages/core-<name>/
# Expect: zero diff (modulo .hbs strip + trailing-newline normalization)

Snapshots live at turbo/generators/__snapshots__/core-package/<name>.snapshot.json.