Quickstart

Getting started3 min read|
|

Create a documentation site and preview it locally in under 3 minutes.

Set your project name:

Scaffold a new documentation project:

docslit init {{PROJECT}}

This creates a {{PROJECT}}/ directory with a starter configuration and three example pages.

cd {{PROJECT}} docslit dev

The dev server starts on http://localhost:3000 with hot reload enabled. Every time you save a file, the browser updates automatically.

Open docs/introduction.md in your editor and make a change. The browser reloads instantly to show your update.

What was created

After running init, your project looks like this:

FilePurpose
docslit.jsonProject configuration — site name and sidebar structure
docs/*.mdYour documentation pages in Markdown
components/Directory for custom web components (optional)

Add a new page

Create docs/guides.md:

--- title: Guides --- # Guides Welcome to the guides section. <wc-callout type="info" title="Coming soon"> More guides are on the way. </wc-callout>

Open docslit.json and add "guides" to the pages array:

{ "name": "{{PROJECT}}", "sidebar": [ { "group": "Getting Started", "pages": ["introduction", "installation", "quickstart", "guides"] } ] }

The dev server picks up the config change automatically. Your new page appears in the sidebar.

Build for production

When you are ready to deploy, build a static site:

docslit build

This creates a dist/ directory with everything you need to deploy. See static hosting for deployment guides.

Next steps