CLI Reference
@inkform/cli scaffolds a documentation site powered by
@inkform/framework — pick a theme, get a deployable Next.js project. Like
npx shadcn, but for docs.
npx @inkform/cli@latest init my-docsFlags
| Option | Description |
|---|---|
-t, --theme <name> | aurora | fern | cedar | mono | base | galley |
-o, --openapi <src> | path or URL to an OpenAPI spec for the API Reference |
--from <dir> | scaffold from a local templates directory (development) |
-y, --yes | accept defaults, skip optional prompts |
-h, --help | show help |
Examples
# interactive
npx @inkform/cli@latest init
# pick everything up front
npx @inkform/cli@latest init docs --theme mono
# generate the API Reference from your spec
npx @inkform/cli@latest init api-docs --theme fern --openapi https://example.com/openapi.jsonWhat init actually does
- Asks where to create your project (or takes a directory argument). If
that folder already exists and isn't empty, it moves the current contents
into
existing-contents/and tells you — nothing is silently overwritten. - Asks which theme you want (skipped if
--themeis passed). - Downloads that theme as a standalone Next.js app — from GitHub by
default, or a local templates directory with
--from(used for framework development, not typical end-user usage). - Optionally wires up your OpenAPI spec so the API Reference tab generates from it.
- Prints next steps and points you at the scaffolded project's own README.
See Quickstart for the walkthrough version of this same flow.