Build content sites and interactive pages from one coherent source model.
Markdown for your content. TypeScript for your components, styles, and behavior.
Explore the docs · Browse components · See an example site · Contribute
PureStack turns a content directory into a static website. Write pages in Markdown or Regor MDX, use built-in components where they help, and add browser-side TypeScript only where a page needs behavior. The CLI handles routes, styles, assets, development preview, and release builds.
PureStack in practice: purestack.studio is built from the frontend source in this repository.
Generating a first page is only the beginning. A product keeps changing: new content, new components, new behavior, and new people working on it.
PureStack's architectural bet is that explicit, typed source makes that ongoing work easier for humans and AI tools to inspect and reason about. Content stays in Markdown; components, style builders, and scripts live in TypeScript. The aim is a source model that remains understandable as the product grows.
.mdx and .rmdx pages use Regor components and expressions. Plain .md
files work for prose pages. See the Regor guide
for the markup and browser app model.
mkdir my-site
cd my-site
npm init -y
npm install purestack
mkdir contentYour starting point is just two files:
my-site/
└── content/
├── siteConfig.json
└── index.mdx
content/siteConfig.json
{
"siteTitle": "My Site",
"logo": { "brand": "My Site", "href": "/" },
"outDir": "../dist/site",
"publishDir": "../dist/publish"
}content/index.mdx
---
title: Welcome
description: My first PureStack site.
template: doc
---
# Make something worth reading.
Start with Markdown. Add components when your page needs more.
<Panel tone="info" variant="surface">
<p>Your first PureStack page, ready to make your own.</p>
</Panel>npx purestack serve --content ./contentOpen http://127.0.0.1:4173/. Add content/about.mdx to create /about/.
The server watches your files and reloads the browser as you edit.
npx purestack build --content ./content
npx purestack publish --content ./contentbuild writes to dist/site. publish creates a clean, minified artifact in
dist/publish; it prepares files for deployment but does not upload them.
Both paths come from siteConfig.json and are resolved relative to content.
For browser behavior, add a TypeScript file beside a page and load it with
<PageScript src="./example.ts" />. The purestack package README
has a complete example.
How PureStack fits together
The CLI guide covers the commands and options. Site configuration covers navigation, themes, search, sitemap, localization, and output paths.
The workspace contains the CLI, site generator, UI components, typed HTML/CSS builders, browser scripts, icon providers, and a private VS Code extension.
Explore the packages and source directories
The remaining workspace packages provide shared types, utilities, rendering, and DOM support.
See Contributing for the branch, pull request, CI, and publishing workflow.
Use Node.js 24 and the Yarn version pinned in package.json.
Run commands from the repository root:
corepack enable
yarn install --immutable
yarn build
yarn devyarn dev serves the included sample site. To work on the PureStack website,
run yarn frontend; its development server opens at
http://127.0.0.1:4700/. See the frontend README for
the site-specific workflow.