Introduction

Publier is a CLI-distributed content-site toolkit for technical companies — docs, blog, marketing, and changelog, authored in MDX and deployed anywhere.

Publier is a content-site toolkit for technical companies. Write in MDX, configure with YAML, run publier dev. You get a polished site covering your full content surface — docs, blog, marketing, changelog, status page, knowledge base — at a design bar most teams can’t reach when building it themselves.

Built on Qwik + Astro. Most components are zero-JS HTML with CSS animation; a small set use lightweight web components for progressive enhancement. The MDX pipeline is pre-wired with sensible defaults.

How it works

Install the CLI. Grab the binary with curl -fsSL https://publier.net/install.sh | sh.
Scaffold. publier new my-site picks a template, sets your brand colors, and runs install.
Write. Add .mdx files to src/content/docs/. Each file becomes a route.
Configure. publier.config.yaml for site behavior; theme.yaml for brand colors.
Ship. publier build outputs production-grade static HTML deployable anywhere.

Get started

InstallationScaffold a project and run the dev server in under 60 seconds.

Content authoringMDX frontmatter, callouts, code blocks, tabs, snippets, and sidebar ordering.

ConfigurationFull reference for astro.config.ts, publier.config.yaml, and theme.yaml.

ThemingPick a built-in color theme or override its CSS variables.

Guides

All guidesOpenAPI, snippets, diagrams, math, plugins, versioning, and more.

ComponentsMDX primitives — callouts, cards, tabs, steps, file trees.

UI componentsPre-built brand and marketing components — hero, pricing, testimonials, footer.

AI featuresAskAi component and llms.txt generation.

IntegrationsPagefind search, Mermaid diagrams, KaTeX math, analytics.

Templates

Templates overviewScaffold from docs, blog, company-site, or full — then toggle individual pages on or off.

Pages referenceCompany-site sub-pages and standard pages — enable, disable, customize.