Usage

This guide covers the standard development workflow for a Thulite project.

See Commands for full command details.

Create content

Add new pages with the create script. This command creates files in your content/ directory using your project’s archetypes.

npm run create about.md

pnpm run create about.md

yarn run create about.md

bun run create about.md

Set draft: false in front matter when the page is ready to publish.

Open your project folder in your editor and run the development server so your browser refreshes while you work.

npm run dev

pnpm run dev

yarn dev

bun run dev

When the server starts, open the local URL shown in your terminal (for example, http://localhost:1313/).

Run the formatter before building or opening a pull request to keep Markdown, styles, and scripts consistent.

npm run format

pnpm run format

yarn format

bun run format

Before deploying, stop the development server (Ctrl + C) and create a production build.

npm run build

pnpm run build

yarn build

bun run build

This generates deploy-ready output in public/ and surfaces build errors early.

Preview the built site locally to validate what will actually be deployed.

npm run preview

pnpm run preview

yarn preview

bun run preview

Preview uses your most recent build. If you make code changes after building, run the build command again before previewing.

To test on other devices in your local network (for example, a phone), use --host with preview:

npm run build && npm run preview -- --host

pnpm run build && pnpm run preview --host

yarn build && yarn preview --host

bun run build && bun run preview --host

Once everything looks good in preview, deploy your site.