Installation

Petit requires Node.js 24 or later. It works with any project regardless of language or framework.

New project

Run the init command from your project root:

npx @ephem-sh/petit init

pnpm dlx @ephem-sh/petit init

bun x @ephem-sh/petit init

yarn dlx @ephem-sh/petit init

Petit asks for confirmation, then creates a config file and a starter docs folder:

my-project/
  petit.config.json
  docs/
    getting-started/
      overview.md

The config file points directly to your content folders:

{
  "title": "My Docs",
  "sidebar": [
    { "label": "Getting Started", "path": "./docs/getting-started" }
  ]
}

Start the dev server:

npx @ephem-sh/petit dev

pnpm dlx @ephem-sh/petit dev

bun x @ephem-sh/petit dev

yarn dlx @ephem-sh/petit dev

Your docs are live at http://localhost:4321.

Existing project

If you already have markdown files, generate just the config:

npx @ephem-sh/petit config

pnpm dlx @ephem-sh/petit config

bun x @ephem-sh/petit config

yarn dlx @ephem-sh/petit config

Then add your content folders to the sidebar. Each path points directly to a folder containing .md files, relative to the config:

{
  "title": "My Docs",
  "sidebar": [
    { "label": "Guides", "path": "./docs/guides" },
    { "label": "API", "path": "./packages/core/docs" }
  ]
}

This works across monorepos too. You can pull documentation from multiple locations in your project.

Project structure

The config lives at your project root. Sidebar paths point directly to folders with markdown:

my-project/
  petit.config.json
  src/
  docs/
    media/
      logo.png
    getting-started/
      overview.md
    guides/
      deployment.md

Images go in a media/ folder inside your docs directory. See the media reference for details.

Package scripts

Add shortcuts to your package.json:

{
  "scripts": {
    "docs:dev": "npx @ephem-sh/petit dev",
    "docs:build": "npx @ephem-sh/petit build"
  }
}

CLI reference

All commands run from your project root:

init and config ask for confirmation before creating files. Pass --yes to skip the prompt.