Typography

Platform sync: week 27

July 3, 2026 · 25 min · recording available

Decisions

  • Ship the streaming endpoint behind a flag on Tuesday.
  • Adopt cursor pagination for the activity feed.
  • Postpone the queue migration until it solves a current failure.

Action items

  • Add the kill switch
  • Publish the latency dashboard

If an alert fires twelve times and is actioned zero times, it is a screensaver.

Typeset is an optional stylesheet for semantic HTML and rendered Markdown. Add typeset to a container and its headings, paragraphs, lists, tables, code, media, and other content elements receive a consistent reading rhythm.

It uses Basecoat’s color, radius, and font tokens, supports dark mode and RTL, and requires no JavaScript. It is shipped separately so applications that do not render long-form content do not pay for it.

Usage

Include CSS

Import Typeset after Tailwind and a Basecoat style bundle.

@import 'tailwindcss';
@import 'basecoat-css/vega.css';
@import 'basecoat-css/typeset.css';

With the CDN, load the optional Typeset build after Basecoat.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/basecoat-css@1.2.1/dist/basecoat.cdn.min.css" />
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/basecoat-css@1.2.1/dist/typeset.cdn.min.css" />

Wrap your content

Add typeset to the element containing your HTML or rendered Markdown.

<article class="typeset">
  <h1>Release notes</h1>
  <p>Everything that changed in this release.</p>
  <h2>Added</h2>
  <ul>
    <li>Typeset support for semantic HTML.</li>
    <li>Configurable reading rhythm.</li>
  </ul>
</article>

Typeset does not set a maximum width. Your layout owns the measure, for example with max-w-2xl.

Examples

Custom presets

Six custom properties control the fonts and reading rhythm. Define as many preset classes as your application needs.

.typeset-chat {
  --typeset-leading: 1.6;
  --typeset-flow: 1em;
}

.typeset-docs {
  --typeset-font-body: var(--font-sans);
  --typeset-font-heading: var(--font-sans);
  --typeset-font-mono: var(--font-mono);
  --typeset-size: 15px;
  --typeset-leading: 1.75;
  --typeset-flow: 1.5em;
}
<div class="typeset typeset-chat">
  ...
</div>
<article class="typeset typeset-docs">
  ...
</article>
PropertyDefaultPurpose
--typeset-font-bodyinheritBody text family.
--typeset-font-heading--font-heading or inheritedHeading family.
--typeset-font-mono--font-monoInline and block code family.
--typeset-size1emBase text size. Typeset renders it at 1.125 times this value below 48rem.
--typeset-leading1.75Body line height.
--typeset-flow1.25emSpace between content blocks.

Rich content

Typeset styles plain elements without requiring classes on each child.

Deploying safely

Run npm run check before deploying. The command verifies the package, documentation, and generated assets.

Why this matters

A successful build catches missing exports and invalid CSS before release.


Production
The environment serving customer traffic.
Preview
An isolated deployment used for verification.

Opting out

Add not-typeset or data-not-typeset to a subtree that should keep its own component styles. This also excludes automatic flow spacing; add mt-(--typeset-flow) when an embedded component follows text.

<article class="typeset">
  <p>This paragraph uses Typeset.</p>
  <div class="card not-typeset mt-(--typeset-flow)">
    <header>
      <h3>Component content</h3>
      <p>This card keeps its Basecoat styles.</p>
    </header>
  </div>
</article>

Unlike shadcn/ui, Basecoat does not use data-slot markup. Embedded components are therefore excluded explicitly with not-typeset or data-not-typeset.

Wide tables

Tables wrap to their available width by default. Wrap a table in typeset-scroll when horizontal scrolling is preferable.

EnvironmentRegionVersionStatus
ProductionSingapore1.1.0Healthy
PreviewFrankfurt1.2.0-beta.1Building
<article class="typeset">
  <div class="typeset-scroll" role="region" aria-label="Deployment environments" tabindex="0">
    <table>
      <!-- Table headings and rows -->
    </table>
  </div>
</article>

Streaming content

Typeset uses start margins and avoids layout rules based on :last-child, :has(), or :empty. Appending a new block therefore does not restyle blocks that were already rendered, which makes it suitable for streaming chat and progressively rendered Markdown.

RTL

Logical margins, padding, and borders follow the document direction automatically.

ملاحظات الإصدار

يوفر Typeset تنسيقًا متناسقًا للمحتوى الدلالي والنصوص المحولة من Markdown.

  • يدعم الوضع الداكن تلقائيًا.
  • يتبع اتجاه المستند.