Publishing

The CLI is not on npm yet. Build it from the monorepo and put the binary on your path:

pnpm install
pnpm --filter @design-drafts/cli build
# the binary is packages/cli/bin.js

Previews are served from GitHub Pages, so they need a repo to live in. init creates one and scaffolds a starter draft in the current directory:

design-drafts init

Both halves work on their own: design-drafts init host sets up the repo and is idempotent, design-drafts init draft writes only the draft.

From the draft directory:

design-drafts                  # push "." (push is the default command)
design-drafts ./path/to/draft  # or point at a directory

The CLI copies the directory to a temporary directory, renders any markdown, embeds the deploy workflow, and force-pushes the result to drafts/<name>. The Deploy Preview workflow publishes it from there.

The push prints the URL, flagged as not live yet: it exists once the workflow finishes. A pull request is not required for deployment.

On this host the Pages site is laid out like this:

A host declares that d/ in the design-drafts.config.json at the root of its default branch:

{ "draftsPath": "d" }

The CLI fetches it from the remote when it prints a preview URL and when it bakes the base path into a draft's search links. Without a declaration, drafts publish to the site root.

To get the site content without git or GitHub:

design-drafts build --out ../my-draft-site

Same rendering, same search index, same generated listing as a push. --out is required and must sit outside the draft, because HTML left inside it would make the next preview or push read the draft as hand-written HTML.

Search result links assume the site is served from /. Pass --base to say otherwise, or --repo to derive the path a push to that host would have used.

Each value resolves from a CLI flag first, then a DESIGN_DRAFTS_* env var, then ~/design-drafts.config.json. Missing required values are prompted for.

Every push records source metadata in its commit message: the source SHA and repo, the author, the manifest's prompt, and a hash of the manifest. A preview traces back to what produced it.