---
title: "Threadline"
description: "Compact neutral theme with right-aligned page actions"
canonical_url: "https://docs.farming-labs.dev/docs/themes/threadline"
markdown_url: "https://docs.farming-labs.dev/docs/themes/threadline.md"
last_updated: "2018-10-20"
agent:
  tokenBudget: 750
---

# Threadline
URL: /docs/themes/threadline
LLM index: /llms.txt
Description: Compact neutral theme with right-aligned page actions
Related: /docs/themes, /docs/customization/page-actions, /docs/customization/typography, /docs/themes/creating-themes

# Threadline Theme

Both `threadline` and `threadlinePageActions` come from `@farming-labs/theme/threadline`; their config fields are `theme: threadline()` and `pageActions: threadlinePageActions`, with styles from `@farming-labs/theme/threadline/css`.
Verify the 48px header, compact Geist typography, 944px content width, and ghost-style action menu. The GitHub provider additionally requires top-level `github.url` in `docs.config.ts`.
For a missing GitHub action, `github.url` is the relevant recovery; for an absent compact shell, the `/threadline/css` import is the relevant check.

A compact neutral preset for chat, agent, and product documentation. It uses a 48px header, compact Geist typography, muted shadcn surfaces, and ghost-style page actions for dense, readable docs.

## Usage

```tsx title="docs.config.ts"
import { defineDocs } from "@farming-labs/docs";
import { threadline, threadlinePageActions } from "@farming-labs/theme/threadline";

export default defineDocs({
  entry: "docs",
  theme: threadline(),
  github: {
    url: "https://github.com/acme/docs",
  },
  pageActions: threadlinePageActions,
});
```

```css title="app/global.css"
@import "tailwindcss";
@import "@farming-labs/theme/threadline/css";
```

## Page Actions

`threadlinePageActions` enables:

- Copy page
- Open in GitHub
- Open in ChatGPT
- Open in Claude
- Open in Cursor
- Open in T3 Chat

The GitHub action needs top-level `github` config so the theme can resolve `{githubUrl}` for the current page.

## Defaults

| Property      | Value                                  |
| ------------- | -------------------------------------- |
| Primary       | `oklch(0.205 0 0)`                     |
| Background    | `oklch(1 0 0)` (light), `oklch(0.145 0 0)` (dark) |
| Border        | `oklch(0.922 0 0)`                     |
| Border radius | `0.625rem`                             |
| Content width | 944px                                  |
| Sidebar width | 260px                                  |
| TOC width     | 224px                                  |
| Header height | 48px                                   |

## Style Notes

- Geist-first typography with smaller headings and dense prose
- Transparent sidebar with soft hover and active states
- Muted cards, tables, inline code, and code blocks
- Blue documentation links and info callouts on an otherwise neutral shell
- Ghost-style page-action buttons with a compact Open in menu

## Customizing

```tsx title="customizing.tsx"
theme: threadline({
  ui: {
    colors: { primary: "#111827" },
    layout: { sidebarWidth: 280, tocWidth: 240 },
  },
}),
```

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).