Getting Started
Install
Install from npm (or copy fonts.css, tokens.css, tokens-core.css, tokens-palette.css, prose.css, and fonts/ directly — tokens.css imports the other three stylesheets, so they travel together):
npm install remarque-tokensThen import fonts first, tokens second, before your other styles. With a bundler and the npm package:
CSS (npm)
@import 'remarque-tokens/fonts.css';
@import 'remarque-tokens';Copy the .woff2 files from node_modules/remarque-tokens/fonts/ into your static assets. Tailwind v4 projects also add @import "remarque-tokens/theme.css"; after the tokens; Tailwind v3 projects use remarque-tokens/tailwind (tailwind.config.js) instead. With copied files:
Plain HTML
<link rel="stylesheet" href="fonts.css">
<link rel="stylesheet" href="tokens.css">Astro
---
import '../styles/fonts.css';
import '../styles/tokens.css';
---Next.js
// app/layout.tsx
import './fonts.css';
import './tokens.css';Use the typography classes (.text-display, .text-title, .text-meta), content width utilities (.content-reading, .content-standard), and the .remarque-prose wrapper for article content.
Page Archetypes
Every page built with Remarque must conform to one of seven archetypes: Essay, Project Dossier, Notebook, Landing, Reference/Docs, Changelog, and Gallery. The four core ones are below — copy the HTML, adjust the content. REMARQUE.md specifies the other three.
Essay
<article class="pt-24">
<header class="content-reading mb-8">
<h1 class="text-display font-display">Your Title</h1>
<div class="mt-4 font-mono text-meta text-muted">
2026-04-11 · 8 min read · topic
</div>
</header>
<div class="remarque-prose content-reading">
<p class="text-body-lg text-fg">Lead paragraph...</p>
<h2>Section Heading</h2>
<p>Body text...</p>
</div>
</article>Project Dossier
<article class="pt-24">
<header class="content-standard mb-8">
<h1 class="text-display font-display">Project Name</h1>
<p class="mt-4 text-body-lg text-fg max-w-reading">
One-paragraph summary.
</p>
</header>
<div class="content-standard mb-12 p-6 border rounded-md">
<dl class="grid grid-cols-[auto_minmax(0,1fr)] gap-x-8 gap-y-2 font-mono text-meta">
<dt class="text-muted">Status</dt>
<dd>Active</dd>
</dl>
</div>
<div class="remarque-prose content-reading">
<h2>Architecture</h2>
<p>Technical details...</p>
</div>
</article>Notebook
<div class="pt-24">
<h1 class="text-display font-display">Notes</h1>
<div class="mt-12 content-reading">
<article class="py-6 border-b">
<div class="font-mono text-meta text-muted mb-2">
2026-04-11 · topic
</div>
<p class="text-body">Note content...</p>
</article>
</div>
</div>Landing
<div class="pt-32 pb-24">
<h1 class="text-display font-display max-w-[20ch]">
Your identity statement.
</h1>
<p class="mt-6 text-body-lg text-fg content-reading">
One paragraph of context.
</p>
</div>
<div class="border-t pt-8">
<div class="grid grid-cols-3 gap-8 content-standard">
<a href="/section">
<h2 class="text-section font-display">Section</h2>
<p class="mt-2 text-body text-fg-muted">Description.</p>
</a>
</div>
</div>