create-sh3

Scaffolding tool for SH3 shard and app projects.

npm create sh3 <project-name> [--type=shard|app|combo]
cd <project-name>
npm install
npm run build:artifact

The artifact lands in dist/artifact/ (manifest.json + client.js) ready to drop into an sh3-server's data/packages/<id>/ directory or POST to a registry.

What you get

The --type flag picks the scaffold shape (default: combo):

| Type | What's in src/ | When to pick it | | -------- | --------------------------------- | -------------------------------------------------------------- | | shard | one shard with a :main view | publishing reusable views/services for other apps to consume | | app | one app with requiredShards: [] | composing existing shards into a workspace; fill in your deps | | combo | one shard and its sibling app | a self-contained workspace that ships its own shard |

Edit src/shards/<name>/ and/or src/apps/<name>/ to grow it.

Build numbers (test iterations)

The scaffolded vite.artifact.ts enables sh3Artifact({ buildSuffix: 'auto' }) by default. Each build past your latest git tag gets a +N suffix in manifest.json.version (1.2.3 → 1.2.3+4). Bump package.json.version only when you cut a real release; iterate freely in between. Set buildSuffix: '' to disable.

Part of the SH3 monorepo.