ENFR0.1.0-rc.3

Your first site

From an empty folder to a built documentation site.


Your first site
0:00 / 0:28
  1. Install the CLI

    Run the install command in your project folder.

    terminal
    npm install --save-dev @specistry/cli
  2. Create the configuration

    Add specistry.config.ts at the project root. Two fields are required: schemaVersion and name.

    specistry.config.ts
    import { defineConfig } from "@specistry/config";
    
    export default defineConfig({
      schemaVersion: 1,
      name: "Acme docs",
    });
  3. Write your first page

    docs/index.md becomes the site homepage. Every page starts with frontmatter and a title.

    docs/index.md
    ---
    title: Acme developer docs
    description: Everything you need to integrate.
    ---
    
    Welcome. Start with the quickstart.
  4. Validate and build

    Validation writes nothing. The build writes a complete artifact under .specistry/artifacts, or nothing at all.

    terminal
    npx specistry validate
    npx specistry build

TipNext

Add more pages and a sidebar in the next tutorial, or bring an OpenAPI contract.

Report an issue with this page on GitHub