# refrakt.md

> A content framework built on Markdoc. Extend Markdown with 100+ semantic runes — tags that transform standard Markdown into structured, SEO-rich, machine-readable content.

Full documentation: https://refrakt.md/docs/getting-started

## Docs

### Blog

- [Blog](https://refrakt.md/blog): Updates, tutorials, and insights about building with refrakt.md
- [What's New in 0.4.0](https://refrakt.md/blog/whats-new-in-0-4): New packages, seven new runes, theme restructuring, syntax highlighting, and more.
- [What's New in 0.5.0](https://refrakt.md/blog/whats-new-in-0-5): Theme development toolkit, behaviors library, six new runes, VS Code language server, and a major architecture shift toward framework-agnostic rendering.
- [What's New in 0.6.0](https://refrakt.md/blog/whats-new-in-0-6): A full WYSIWYG editor, framework-neutral web components, layout transform engine, AI-powered theme designer, and a Python extraction pipeline.
- [What's New in 0.7.0](https://refrakt.md/blog/whats-new-in-0-7): Eight official rune packages and new tooling for package authors.
- [What's New in 0.8.0](https://refrakt.md/blog/whats-new-in-0-8): Declarative content models, a cross-page pipeline, media runes with streaming, and identity transform improvements.
- [What's New in 0.9.0](https://refrakt.md/blog/whats-new-in-0-9): Metadata dimensions, universal theming, rune output standards, the plan package, Markdoc partials, and a Lumina design refresh.

### Docs

- [Adapters](https://refrakt.md/docs/adapters/adapters-overview): How refrakt.md connects to different rendering targets
- [Astro Adapter](https://refrakt.md/docs/adapters/astro): Using refrakt.md with Astro for static site generation and MPA content sites
- [Eleventy Adapter](https://refrakt.md/docs/adapters/eleventy): Using refrakt.md with Eleventy v3 — the simplest adapter, no bundler required
- [HTML Adapter](https://refrakt.md/docs/adapters/html): Pure HTML rendering for refrakt.md — no framework required
- [Next.js Adapter](https://refrakt.md/docs/adapters/nextjs): Using refrakt.md with Next.js App Router and React Server Components
- [Nuxt Adapter](https://refrakt.md/docs/adapters/nuxt): Using refrakt.md with Nuxt 3 for SSR, Vue components, and auto-imports
- [SvelteKit Adapter](https://refrakt.md/docs/adapters/sveltekit): Using refrakt.md with SvelteKit for SSR, client-side navigation, and Svelte components
- [Moved](https://refrakt.md/docs/authoring/authoring-overview)
- [Moved](https://refrakt.md/docs/authoring/content-models)
- [Entities](https://refrakt.md/docs/authoring/entities): What an entity is, where entities come from, and how the runes that query them fit together.
- [Frontmatter](https://refrakt.md/docs/authoring/frontmatter): Every frontmatter field refrakt reads — generated from the schema, so it cannot fall behind the code
- [Nav slug resolution](https://refrakt.md/docs/authoring/nav-slug-resolution): How nav item slugs resolve to URLs at build time, and how the active state is applied per page
- [Moved](https://refrakt.md/docs/authoring/output-contract)
- [Page sections](https://refrakt.md/docs/authoring/page-sections): How to add an eyebrow, headline, and blurb above rune content
- [Partials](https://refrakt.md/docs/authoring/partials): Reusable content fragments shared across pages
- [Moved](https://refrakt.md/docs/authoring/patterns)
- [Rich menubar panels and column flow](https://refrakt.md/docs/authoring/rich-menubar-panels): How to compose Linear / Vercel / Stripe-style header dropdowns from the existing nav primitives — slot rule, column flow, strip layout, and mobile patterns
- [Tint and colour scheme](https://refrakt.md/docs/authoring/tint): How tint, tint-mode, and tint-lock cascade from site config down through layouts to individual pages.
- [Content variables](https://refrakt.md/docs/authoring/variables): The author-facing Markdoc variables — frontmatter, page metadata, and source-file metadata
- [CLI Overview](https://refrakt.md/docs/cli/cli-overview): Command-line tools for content generation, theme development, and project management
- [refrakt inspect](https://refrakt.md/docs/cli/inspect): Preview identity transform output for any rune and audit CSS coverage
- [refrakt reference](https://refrakt.md/docs/cli/reference): Emit rune syntax reference for human contributors and AI coding agents
- [Theme Tools](https://refrakt.md/docs/cli/theme-tools): CLI commands for generating contracts, scaffolding CSS, validating configs, and managing themes
- [refrakt write](https://refrakt.md/docs/cli/write): Generate Markdown content files using AI providers
- [Entity routes](https://refrakt.md/docs/configuration/entity-routes): Generate one page per registered entity from refrakt.config.json, without writing a pipeline hook.
- [Internationalization (i18n)](https://refrakt.md/docs/configuration/i18n): How refrakt localizes framework-generated UI text — labels, chrome, behaviors — and how to configure a non-English locale
- [Migration](https://refrakt.md/docs/configuration/migration): Moving from the legacy flat-shape config to the unified nested form.
- [Configuration Overview](https://refrakt.md/docs/configuration/overview): refrakt.config.json — the project-level config that drives content, sites, plan, and plugins.
- [Plan Configuration](https://refrakt.md/docs/configuration/plan): The `plan` section — controlling where plan content lives.
- [Plugins](https://refrakt.md/docs/configuration/plugins): Browse the official refrakt plugins, install them, and configure how the rune set resolves.
- [Configuration reference](https://refrakt.md/docs/configuration/reference): Every field a site accepts in refrakt.config.json — generated from the schema, so it cannot fall behind the code
- [Schema](https://refrakt.md/docs/configuration/schema): The published JSON Schema for refrakt.config.json — editor autocomplete and validation.
- [Setting up Search](https://refrakt.md/docs/configuration/search): How the built-in search works, how to enable results with Pagefind, and how to turn search off.
- [Sites](https://refrakt.md/docs/configuration/sites): Single-site vs multi-site configuration; the SiteConfig fields.
- [Content & Routing](https://refrakt.md/docs/content): Frontmatter fields, URL routing, layout cascade, and content organization
- [Getting Started](https://refrakt.md/docs/getting-started): Set up refrakt.md and create your first content
- [Errors](https://refrakt.md/docs/mcp/errors): Error envelope shape and error codes returned by the MCP server.
- [Installation](https://refrakt.md/docs/mcp/installation): Register the refrakt MCP server with Claude Desktop, Claude Code, Cursor, and other MCP clients.
- [MCP Server Overview](https://refrakt.md/docs/mcp/overview): Run the refrakt CLI as a Model Context Protocol server so AI agents can call refrakt operations through typed tools and structured I/O.
- [Resources](https://refrakt.md/docs/mcp/resources): Read-only addressable URIs the MCP server exposes for browsing project state.
- [Tools](https://refrakt.md/docs/mcp/tools): Full reference for the MCP server's tool surface — core tools and plugin-discovered tools.
- [Migrating to v0.14.0](https://refrakt.md/docs/migration/v0.14.0): Breaking changes in v0.14.0 and how to update existing sites and plugins.
- [Moved](https://refrakt.md/docs/plugins)
- [Moved](https://refrakt.md/docs/plugins/authoring)
- [Moved](https://refrakt.md/docs/plugins/extending-core)
- [Moved](https://refrakt.md/docs/plugins/pipeline)
- [Moved](https://refrakt.md/docs/security)
- [Moved](https://refrakt.md/docs/themes/components)
- [Moved](https://refrakt.md/docs/themes/config-api)
- [Moved](https://refrakt.md/docs/themes/creating-a-theme)
- [Moved](https://refrakt.md/docs/themes/css)
- [Moved](https://refrakt.md/docs/themes/dimensions)
- [Moved](https://refrakt.md/docs/themes/layouts)
- [Moved](https://refrakt.md/docs/themes/overview)
- [Moved](https://refrakt.md/docs/themes/tint-cascade)
- [Moved](https://refrakt.md/docs/themes/tooling)

### Extend

- [Extend refrakt](https://refrakt.md/extend): Build custom runes, themes, and plugins on top of refrakt's core
- [Contributing](https://refrakt.md/extend/contributing): How this repo runs — branches, the plan workflow, releases, and where to file issues
- [Distributing extensions](https://refrakt.md/extend/distributing): Author and publish plugins, themes, templates, and preset packs
- [Authoring preset packs](https://refrakt.md/extend/distributing/preset-packs): Ship token-override presets independent of a theme
- [Authoring site templates](https://refrakt.md/extend/distributing/templates): Package a purpose-built site as a distributable template
- [Moved](https://refrakt.md/extend/i18n/overview)
- [Translating refrakt](https://refrakt.md/extend/i18n/translating): Contribute a language — extract the keys, translate the bundle, and get coverage measured
- [Building a Custom Plugin](https://refrakt.md/extend/plugin-authoring/authoring): How to author a Plugin with custom rune schemas, theme config, and pipeline hooks
- [Extending Core Runes](https://refrakt.md/extend/plugin-authoring/extending-core): How to add attributes to existing core runes from a plugin
- [Fixtures](https://refrakt.md/extend/plugin-authoring/fixtures): The standardised rune-fixture format — Markdoc + YAML frontmatter — that powers examples, the gallery, the inspect command, docs, and AI few-shot.
- [Hosted & In-Memory Builds](https://refrakt.md/extend/plugin-authoring/hosted-builds): The ProjectFiles seam and the fetch-then-build materialization pattern for rendering a repo with no local filesystem
- [Cross-Page Pipeline](https://refrakt.md/extend/plugin-authoring/pipeline): How to use build-time pipeline hooks to build site-wide indexes and cross-page references
- [Rune Authoring Overview](https://refrakt.md/extend/rune-authoring/authoring-overview): Mental model, transformation pipeline, and anatomy of a rune
- [Composability Contract](https://refrakt.md/extend/rune-authoring/composability): How runes nest and compose — the open-world contract every rune participates in
- [Composed Runes](https://refrakt.md/extend/rune-authoring/composed-runes): Define a rune as a Markdown file that places existing runes — the file, the template vocabulary, what a template may place, where definitions go, and every error the compiler reports
- [Declarative Content Models](https://refrakt.md/extend/rune-authoring/content-models): Define rune content structure with contentModel
- [Moved](https://refrakt.md/extend/rune-authoring/nav-slug-resolution)
- [Output Contract](https://refrakt.md/extend/rune-authoring/output-contract): What runes produce and how the identity transform engine consumes it
- [Moved](https://refrakt.md/extend/rune-authoring/page-sections)
- [Moved](https://refrakt.md/extend/rune-authoring/partials)
- [Patterns & Best Practices](https://refrakt.md/extend/rune-authoring/patterns): Canonical patterns for writing consistent, maintainable runes
- [Declaring Registration](https://refrakt.md/extend/rune-authoring/registration): Put a rune's entities and edges into the cross-page registry with a `registers` block instead of a pipeline hook
- [Moved](https://refrakt.md/extend/rune-authoring/rich-menubar-panels)
- [Security Policy](https://refrakt.md/extend/security): Configuring the transform pipeline to render untrusted author content safely.
- [Blocks & layout](https://refrakt.md/extend/theme-authoring/blocks-and-layout): Plugins declare a metaFields data manifest, project named metadata blocks from it, and assemble the whole skeleton via the recursive layout tree. SPEC-080 / SPEC-081.
- [Interactive Components](https://refrakt.md/extend/theme-authoring/components): How runes achieve interactivity through behaviors, postTransform hooks, and element overrides
- [Theme Config API](https://refrakt.md/extend/theme-authoring/config-api): Complete reference for ThemeConfig, RuneConfig, and StructureEntry — the declarative API for theme development
- [Creating a Theme](https://refrakt.md/extend/theme-authoring/creating-a-theme): Step-by-step guide to building a custom refrakt.md theme from scratch
- [CSS Architecture](https://refrakt.md/extend/theme-authoring/css): BEM conventions, design tokens, variant styling patterns, and dark mode support
- [Universal Theming Dimensions](https://refrakt.md/extend/theme-authoring/dimensions): Semantic data attributes that enable generic cross-rune styling — metadata badges, density, sections, media, state, and more
- [Layouts](https://refrakt.md/extend/theme-authoring/layouts): Declarative page layout system — LayoutConfig reference, slots, computed content, chrome, and behaviors
- [Motion dimension](https://refrakt.md/extend/theme-authoring/motion): The theme-side motion dimension — the reveal character contract, the physics tokens, the data-reveal × data-in-view choreography, transform composition, and the data-animate enhancement gate (SPEC-105)
- [Theme Overview](https://refrakt.md/extend/theme-authoring/overview): What a refrakt.md theme is, how the two-layer system works, and how themes are structured
- [Surface model](https://refrakt.md/extend/theme-authoring/surfaces): The theme-side surface model — frame/background preset registries, frameTarget/substrateTarget routing, the inset token, host-owned clip, and the substrate ownership split (SPEC-086/087)
- [Tint cascade](https://refrakt.md/extend/theme-authoring/tint-cascade): How the tint cascade resolves at build time, and the SSR contract a theme or adapter has to honour.
- [CLI Tooling](https://refrakt.md/extend/theme-authoring/tooling): CLI tools have moved to their own documentation section
- [Moved](https://refrakt.md/extend/variables)

### Plan

- [Plan — Project Planning in Your Repo](https://refrakt.md/plan): Structured project planning with specs, work items, decisions, and milestones that live in your repository and publish as a browsable site
- [Plan CLI Reference](https://refrakt.md/plan/docs/plan-cli): Complete reference for all refrakt plan CLI commands
- [Plan Entities](https://refrakt.md/plan/docs/plan-entities): Reference for all plan entity types — specs, work items, bugs, decisions, and milestones
- [Add Plan to an Existing Site](https://refrakt.md/plan/docs/plan-integrate): Wire @refrakt-md/plan into a docs or marketing site you already have — plugin, config, per-entity routes, and dashboard runes
- [Plan Overview](https://refrakt.md/plan/docs/plan-overview): Structured project planning with specs, work items, decisions, and milestones — managed from the CLI and publishable as a site
- [Publish a Plan Site](https://refrakt.md/plan/docs/plan-site): Scaffold a standalone deployable plan site, or wire plan routes into an existing refrakt site with entityRoutes — dashboards and a page per entity
- [Workflow](https://refrakt.md/plan/docs/plan-workflow): The day-to-day cycle of creating, prioritizing, and completing plan entities

### Releases

- [Changelog](https://refrakt.md/releases): Release history for refrakt.md
- [v0.10.0](https://refrakt.md/releases/v0.10.0): What changed in refrakt.md v0.10.0
- [v0.10.1](https://refrakt.md/releases/v0.10.1): What changed in refrakt.md v0.10.1
- [v0.11.0](https://refrakt.md/releases/v0.11.0): What changed in refrakt.md v0.11.0
- [v0.11.1](https://refrakt.md/releases/v0.11.1): What changed in refrakt.md v0.11.1
- [v0.11.2](https://refrakt.md/releases/v0.11.2): What changed in refrakt.md v0.11.2
- [v0.11.3](https://refrakt.md/releases/v0.11.3): What changed in refrakt.md v0.11.3
- [v0.12.0](https://refrakt.md/releases/v0.12.0): What changed in refrakt.md v0.12.0
- [v0.14.0](https://refrakt.md/releases/v0.14.0): What changed in refrakt.md v0.14.0
- [v0.14.1](https://refrakt.md/releases/v0.14.1): What changed in refrakt.md v0.14.1
- [v0.14.2](https://refrakt.md/releases/v0.14.2): What changed in refrakt.md v0.14.2
- [v0.14.3](https://refrakt.md/releases/v0.14.3): What changed in refrakt.md v0.14.3
- [v0.14.4](https://refrakt.md/releases/v0.14.4): What changed in refrakt.md v0.14.4
- [v0.15.0](https://refrakt.md/releases/v0.15.0): What changed in refrakt.md v0.15.0
- [v0.16.0](https://refrakt.md/releases/v0.16.0): What changed in refrakt.md v0.16.0
- [v0.16.1](https://refrakt.md/releases/v0.16.1): What changed in refrakt.md v0.16.1
- [v0.17.0](https://refrakt.md/releases/v0.17.0): What changed in refrakt.md v0.17.0
- [v0.18.0](https://refrakt.md/releases/v0.18.0): What changed in refrakt.md v0.18.0
- [v0.19.0](https://refrakt.md/releases/v0.19.0): What changed in refrakt.md v0.19.0
- [v0.2.0](https://refrakt.md/releases/v0.2.0): What changed in refrakt.md v0.2.0
- [v0.20.0](https://refrakt.md/releases/v0.20.0): What changed in refrakt.md v0.20.0
- [v0.20.1](https://refrakt.md/releases/v0.20.1): What changed in refrakt.md v0.20.1
- [v0.20.2](https://refrakt.md/releases/v0.20.2): What changed in refrakt.md v0.20.2
- [v0.21.0](https://refrakt.md/releases/v0.21.0): What changed in refrakt.md v0.21.0
- [v0.22.0](https://refrakt.md/releases/v0.22.0): What changed in refrakt.md v0.22.0
- [v0.23.0](https://refrakt.md/releases/v0.23.0): What changed in refrakt.md v0.23.0
- [v0.24.0](https://refrakt.md/releases/v0.24.0): What changed in refrakt.md v0.24.0
- [v0.24.1](https://refrakt.md/releases/v0.24.1): What changed in refrakt.md v0.24.1
- [v0.24.2](https://refrakt.md/releases/v0.24.2): What changed in refrakt.md v0.24.2
- [v0.24.3](https://refrakt.md/releases/v0.24.3): What changed in refrakt.md v0.24.3
- [v0.24.4](https://refrakt.md/releases/v0.24.4): What changed in refrakt.md v0.24.4
- [v0.24.5](https://refrakt.md/releases/v0.24.5): What changed in refrakt.md v0.24.5
- [v0.24.6](https://refrakt.md/releases/v0.24.6): What changed in refrakt.md v0.24.6
- [v0.25.0](https://refrakt.md/releases/v0.25.0): What changed in refrakt.md v0.25.0
- [v0.25.1](https://refrakt.md/releases/v0.25.1): What changed in refrakt.md v0.25.1
- [v0.26.0](https://refrakt.md/releases/v0.26.0): What changed in refrakt.md v0.26.0
- [v0.27.0](https://refrakt.md/releases/v0.27.0): What changed in refrakt.md v0.27.0
- [v0.28.0](https://refrakt.md/releases/v0.28.0): What changed in refrakt.md v0.28.0
- [v0.29.0](https://refrakt.md/releases/v0.29.0): What changed in refrakt.md v0.29.0
- [v0.3.0](https://refrakt.md/releases/v0.3.0): What changed in refrakt.md v0.3.0
- [v0.30.0](https://refrakt.md/releases/v0.30.0): What changed in refrakt.md v0.30.0
- [v0.30.1](https://refrakt.md/releases/v0.30.1): What changed in refrakt.md v0.30.1
- [v0.31.0](https://refrakt.md/releases/v0.31.0): What changed in refrakt.md v0.31.0
- [v0.32.0](https://refrakt.md/releases/v0.32.0): What changed in refrakt.md v0.32.0
- [v0.33.0](https://refrakt.md/releases/v0.33.0): What changed in refrakt.md v0.33.0
- [v0.34.0](https://refrakt.md/releases/v0.34.0): What changed in refrakt.md v0.34.0
- [v0.35.0](https://refrakt.md/releases/v0.35.0): What changed in refrakt.md v0.35.0
- [v0.36.0](https://refrakt.md/releases/v0.36.0): What changed in refrakt.md v0.36.0
- [v0.37.0](https://refrakt.md/releases/v0.37.0): What changed in refrakt.md v0.37.0
- [v0.38.0](https://refrakt.md/releases/v0.38.0): What changed in refrakt.md v0.38.0
- [v0.39.0](https://refrakt.md/releases/v0.39.0): What changed in refrakt.md v0.39.0
- [v0.4.0](https://refrakt.md/releases/v0.4.0): What changed in refrakt.md v0.4.0
- [v0.40.0](https://refrakt.md/releases/v0.40.0): What changed in refrakt.md v0.40.0
- [v0.41.0](https://refrakt.md/releases/v0.41.0): What changed in refrakt.md v0.41.0
- [v0.41.1](https://refrakt.md/releases/v0.41.1): What changed in refrakt.md v0.41.1
- [v0.5.0](https://refrakt.md/releases/v0.5.0): What changed in refrakt.md v0.5.0
- [v0.5.1](https://refrakt.md/releases/v0.5.1): What changed in refrakt.md v0.5.1
- [v0.6.0](https://refrakt.md/releases/v0.6.0): What changed in refrakt.md v0.6.0
- [v0.7.0](https://refrakt.md/releases/v0.7.0): What changed in refrakt.md v0.7.0
- [v0.7.1](https://refrakt.md/releases/v0.7.1): What changed in refrakt.md v0.7.1
- [v0.7.2](https://refrakt.md/releases/v0.7.2): What changed in refrakt.md v0.7.2
- [v0.8.0](https://refrakt.md/releases/v0.8.0): What changed in refrakt.md v0.8.0
- [v0.8.1](https://refrakt.md/releases/v0.8.1): What changed in refrakt.md v0.8.1
- [v0.8.2](https://refrakt.md/releases/v0.8.2): What changed in refrakt.md v0.8.2
- [v0.8.3](https://refrakt.md/releases/v0.8.3): What changed in refrakt.md v0.8.3
- [v0.8.4](https://refrakt.md/releases/v0.8.4): What changed in refrakt.md v0.8.4
- [v0.8.5](https://refrakt.md/releases/v0.8.5): What changed in refrakt.md v0.8.5
- [v0.9.0](https://refrakt.md/releases/v0.9.0): What changed in refrakt.md v0.9.0
- [v0.9.1](https://refrakt.md/releases/v0.9.1): What changed in refrakt.md v0.9.1
- [v0.9.2](https://refrakt.md/releases/v0.9.2): What changed in refrakt.md v0.9.2
- [v0.9.3](https://refrakt.md/releases/v0.9.3): What changed in refrakt.md v0.9.3
- [v0.9.4](https://refrakt.md/releases/v0.9.4): What changed in refrakt.md v0.9.4
- [v0.9.5](https://refrakt.md/releases/v0.9.5): What changed in refrakt.md v0.9.5
- [v0.9.6](https://refrakt.md/releases/v0.9.6): What changed in refrakt.md v0.9.6
- [v0.9.7](https://refrakt.md/releases/v0.9.7): What changed in refrakt.md v0.9.7
- [v0.9.8](https://refrakt.md/releases/v0.9.8): What changed in refrakt.md v0.9.8
- [v0.9.9](https://refrakt.md/releases/v0.9.9): What changed in refrakt.md v0.9.9

### Runes

- [Accordion](https://refrakt.md/runes/accordion): Collapsible accordion sections for FAQ-style content
- [Aggregate](https://refrakt.md/runes/aggregate): Project numbers from the registry — counts and per-group breakdowns — the number-projecting counterpart to collection and relationships, with field-match queries and a sub-filter that drives progress-bar ratios
- [Annotate](https://refrakt.md/runes/annotate): Content with margin annotations and notes
- [Badge](https://refrakt.md/runes/badge): Inline pill that flags a piece of content — status, category, recency, tag
- [Bar](https://refrakt.md/runes/bar): Block-level wrapper that renders a horizontal row of content — the bar layout primitive, composable in prose
- [Background](https://refrakt.md/runes/bg): Add background images, video, and overlays to any section rune
- [Blog](https://refrakt.md/runes/blog): Display a list of blog posts from a content folder with sorting, filtering, and layout options
- [Breadcrumb](https://refrakt.md/runes/breadcrumb): Navigation breadcrumbs showing page hierarchy
- [Budget](https://refrakt.md/runes/budget): Structured budgets with categories, line items, and totals
- [@refrakt-md/business](https://refrakt.md/runes/business): Organizational runes for team directories, company profiles, and timelines
- [Cast / Team](https://refrakt.md/runes/business/cast): People directory for team pages and speaker lineups
- [Organization](https://refrakt.md/runes/business/organization): Structured business or organization information
- [Timeline](https://refrakt.md/runes/business/timeline): Chronological events displayed as a timeline
- [Card](https://refrakt.md/runes/card): A generic, self-contained content card — optional media, body, and footer zones, with an optional whole-card link
- [Chart](https://refrakt.md/runes/chart): Chart visualization from a Markdown table
- [Code](https://refrakt.md/runes/code): Inline code span for dynamic content, where backticks cannot reach
- [Codegroup](https://refrakt.md/runes/codegroup): Tabbed code blocks and styled code chrome
- [Collection](https://refrakt.md/runes/collection): Render a list, grid, or table of registry entities — the plural counterpart to ref and expand, with filtering, sorting, grouping, and per-item templates
- [Compare](https://refrakt.md/runes/compare): Side-by-side code comparison panels
- [Conversation](https://refrakt.md/runes/conversation): Chat and dialogue display with alternating speaker messages
- [Data](https://refrakt.md/runes/data): Ingest an external tabular file (CSV, TSV, JSON, NDJSON) and render it as a table, chart, or datatable — shaped at build time
- [DataTable](https://refrakt.md/runes/datatable): Interactive data table with sorting, filtering, and pagination
- [Deflist](https://refrakt.md/runes/deflist): Block-level definition list — stacked dt/dd pairs that flow into multiple columns on wider screens
- [@refrakt-md/design](https://refrakt.md/runes/design): Design system runes for color palettes, typography specimens, and token visualization
- [Design Context](https://refrakt.md/runes/design/design-context): Unified design token card composing palette, typography, and spacing runes with cross-page sandbox injection
- [Mockup](https://refrakt.md/runes/design/mockup): Wrap content in realistic device frames for phones, tablets, browsers, and laptops
- [Palette](https://refrakt.md/runes/design/palette): Color swatch grid with optional WCAG contrast and accessibility info
- [Preview](https://refrakt.md/runes/design/preview): Component showcase with theme toggle and responsive viewports
- [Spacing](https://refrakt.md/runes/design/spacing): Spacing scale, border radius, and shadow token display
- [Swatch](https://refrakt.md/runes/design/swatch): Inline color chip for referencing colors in prose
- [Typography](https://refrakt.md/runes/design/typography): Font specimen display with live Google Fonts loading
- [Details](https://refrakt.md/runes/details): Collapsible disclosure blocks for supplementary content
- [Diagram](https://refrakt.md/runes/diagram): Mermaid diagram rendering from code blocks
- [Diff](https://refrakt.md/runes/diff): Side-by-side or unified diff view between two code blocks
- [@refrakt-md/docs](https://refrakt.md/runes/docs): Technical documentation runes for API references, code symbols, and changelogs
- [API](https://refrakt.md/runes/docs/api): API endpoint documentation with method, path, and parameters
- [Changelog](https://refrakt.md/runes/docs/changelog): Version history with release notes
- [Docs CLI Commands](https://refrakt.md/runes/docs/cli): Command reference for refrakt docs extract — generate API reference docs from source code
- [Symbol](https://refrakt.md/runes/docs/symbol): Code construct documentation for functions, classes, interfaces, enums, and type aliases
- [Drawer](https://refrakt.md/runes/drawer): Addressable modal panel — declared once, opened from any xref on the page
- [Embed](https://refrakt.md/runes/embed): Embed external content like videos, tweets, and code demos
- [Expand](https://refrakt.md/runes/expand): Substitute a registered entity's source content inline — symmetric with xref but inlines the content instead of linking to it
- [Figure](https://refrakt.md/runes/figure): A captioned container for images, code, tables and diagrams, with sizing and alignment
- [File-ref](https://refrakt.md/runes/file-ref): Path-based inline references to project files — third member of the Registry family beside xref (one entity) and expand (one entity inlined), with optional drawer preview
- [Form](https://refrakt.md/runes/form): Accessible HTML forms from Markdown with smart field type inference
- [Gallery](https://refrakt.md/runes/gallery): Multi-image container with grid, carousel, or masonry layout
- [Grid](https://refrakt.md/runes/grid): Flexible grid layout with columns, auto-fill, masonry, and responsive collapse
- [Hint](https://refrakt.md/runes/hint): Callouts and admonitions for supplementary information
- [Icon](https://refrakt.md/runes/icon): Inline icons from the theme's icon registry
- [Image schemes](https://refrakt.md/runes/image-schemes): Custom URL schemes in Markdown image syntax — generated placeholders and inline icons resolved at build time to inline SVG.
- [Include](https://refrakt.md/runes/include): Paste a partial's content into the page during the preprocess phase, so data and snippet inside it resolve
- [Juxtapose](https://refrakt.md/runes/juxtapose): Interactive side-by-side comparison with slider, toggle, fade, and auto modes
- [Layout & Region](https://refrakt.md/runes/layout): Structural runes for defining page layouts and named content regions
- [@refrakt-md/learning](https://refrakt.md/runes/learning): Educational runes for tutorials, recipes, and instructional content
- [HowTo](https://refrakt.md/runes/learning/howto): Step-by-step how-to guide with tools and instructions
- [Recipe](https://refrakt.md/runes/learning/recipe): Structured recipe with ingredients, steps, and chef tips
- [@refrakt-md/marketing](https://refrakt.md/runes/marketing): Landing page and conversion runes for marketing sites and product pages
- [Bento](https://refrakt.md/runes/marketing/bento): Magazine-style bento grid of cells — heading depth sizes each tile, or author cells explicitly for full control
- [Comparison](https://refrakt.md/runes/marketing/comparison): Product and feature comparison matrices from Markdown
- [CTA](https://refrakt.md/runes/marketing/cta): Focused call-to-action blocks with headlines, descriptions, and action buttons
- [Feature](https://refrakt.md/runes/marketing/feature): Feature showcases with name, description, and optional icons
- [Hero](https://refrakt.md/runes/marketing/hero): Full-width intro sections for landing pages with background support and action buttons
- [Pricing](https://refrakt.md/runes/marketing/pricing): Pricing tables with tier comparison
- [Steps](https://refrakt.md/runes/marketing/steps): Step-by-step instructions with numbered indicators
- [Testimonial](https://refrakt.md/runes/marketing/testimonial): Customer testimonials and reviews
- [@refrakt-md/media](https://refrakt.md/runes/media): Audio and music runes for playlists, tracks, and audio players
- [Media guests](https://refrakt.md/runes/media-guests): Drop any rune into a container's media zone — charts, maps, diagrams, code, comparisons, device mockups. The slot sizes and clips them, name-agnostically.
- [Audio](https://refrakt.md/runes/media/audio): Audio player with optional waveform and chapter markers
- [Playlist](https://refrakt.md/runes/media/playlist): Curated playlist with track listing for albums, podcasts, audiobooks, and mixes
- [Track](https://refrakt.md/runes/media/track): Standalone track or recording with metadata
- [MediaText](https://refrakt.md/runes/mediatext): Side-by-side image and text layouts with configurable ratios
- [Motion](https://refrakt.md/runes/motion): Scroll-reveal entrance motion — the closed reveal vocabulary, stagger, the opt-in default, and reduced-motion / no-JS behaviour, with a feature-stagger example.
- [Nav](https://refrakt.md/runes/nav): One navigation primitive for sidebars, header menubars, footer columns, and section landings
- [Pagination](https://refrakt.md/runes/pagination): Sequential prev/next links for ordered docs and tutorials
- [@refrakt-md/places](https://refrakt.md/runes/places): Event planning and location runes for travel guides and venue pages
- [Event](https://refrakt.md/runes/places/event): Event information with date, location, and agenda
- [Itinerary](https://refrakt.md/runes/places/itinerary): Day-by-day travel itineraries with timed stops and locations
- [Map](https://refrakt.md/runes/places/map): Interactive map visualization from Markdown lists of locations
- [@refrakt-md/plan](https://refrakt.md/runes/plan): Spec-driven project planning with AI-native workflows and CLI tooling
- [Backlog](https://refrakt.md/runes/plan/backlog): Aggregation view of plan entities with filtering, sorting, and grouping
- [Bug](https://refrakt.md/runes/plan/bug): Bug report with structured reproduction steps and severity tracking
- [Plan CLI Commands](https://refrakt.md/runes/plan/cli): Command reference for refrakt plan — project management from the terminal
- [Decision](https://refrakt.md/runes/plan/decision): Architecture decision record capturing context, options, rationale, and consequences
- [Decision Log](https://refrakt.md/runes/plan/decision-log): Chronological view of architecture decision records
- [Example Plan Data](https://refrakt.md/runes/plan/examples): Sample plan entities used to populate aggregation rune showcases
- [Milestone](https://refrakt.md/runes/plan/milestone): Named release target with scope, goals, and status tracking
- [Plan Activity](https://refrakt.md/runes/plan/plan-activity): Recent activity feed sorted by file modification time
- [Plan History](https://refrakt.md/runes/plan/plan-history): Git-native entity history timeline showing lifecycle events derived from commits
- [Plan Progress](https://refrakt.md/runes/plan/plan-progress): Per-type completion bars and status breakdowns from the plan registry
- [Spec](https://refrakt.md/runes/plan/spec): Specification document with status tracking, versioning, and cross-referencing
- [Work](https://refrakt.md/runes/plan/work): Work item with acceptance criteria, references, and implementation tracking
- [Plan Workflows](https://refrakt.md/runes/plan/workflow): Using @refrakt-md/plan with AI assistants, CI pipelines, and team workflows
- [Progress](https://refrakt.md/runes/progress): A generic completion bar — render a ratio from supplied numbers, with an optional label and sentiment variant
- [PullQuote](https://refrakt.md/runes/pullquote): Editorial pull quotes with alignment and style variants
- [Relationships](https://refrakt.md/runes/relationships): Render an entity's relationship edges, grouped by kind — the plural-graph counterpart to ref and expand, generic over any domain's relationship vocabulary
- [Reveal](https://refrakt.md/runes/reveal): Progressive disclosure where content appears step by step
- [Rune Catalog](https://refrakt.md/runes/rune-catalog): Browse all available runes — core built-ins and official packages
- [Sandbox](https://refrakt.md/runes/sandbox): Isolated HTML/CSS/JS rendering in an iframe with optional framework loading
- [Section](https://refrakt.md/runes/section): A generic page section — an eyebrow, headline, and blurb above any content
- [Showcase](https://refrakt.md/runes/showcase): Present visual content with frame chrome — shadow, displacement (bleed), offset, and aspect ratio
- [Sidenote](https://refrakt.md/runes/sidenote): Margin notes and footnotes alongside main content
- [Snippet](https://refrakt.md/runes/snippet): Embed a project file as a syntax-highlighted code block — composes inside codegroup, diff, and any future fence-consuming container
- [@refrakt-md/storytelling](https://refrakt.md/runes/storytelling): Worldbuilding and narrative runes for fiction, games, and creative writing
- [Bond](https://refrakt.md/runes/storytelling/bond): Relationship connections between characters or entities
- [Character](https://refrakt.md/runes/storytelling/character): Rich character profiles with sections for backstory, abilities, and more
- [Faction](https://refrakt.md/runes/storytelling/faction): Organizations and groups with ranks, holdings, and alignment
- [Lore](https://refrakt.md/runes/storytelling/lore): In-world knowledge entries for myths, prophecies, and historical records
- [Plot](https://refrakt.md/runes/storytelling/plot): Story arcs and quest trackers with progress markers
- [Realm](https://refrakt.md/runes/storytelling/realm): Location profiles for worldbuilding with geography and notable features
- [Storyboard](https://refrakt.md/runes/storytelling/storyboard): Comic and storyboard layouts from images and captions
- [Surfaces](https://refrakt.md/runes/surfaces): The surface model on one page — chrome (shadow, frame), fills (tint, substrate, gradient), cover layouts, and interaction posture, with the reference tables inline.
- [Tabs](https://refrakt.md/runes/tabs): Tabbed content panels with heading-based tab labels
- [TextBlock](https://refrakt.md/runes/textblock): Styled text blocks with drop caps, columns, and lead paragraphs
- [Tint](https://refrakt.md/runes/tint): Section-level colour overrides via CSS custom properties
- [Table of Contents](https://refrakt.md/runes/toc): Auto-generated table of contents from page headings
- [Xref](https://refrakt.md/runes/xref): Inline cross-references that resolve entities by ID or name from the entity registry

### Themes

- [Catppuccin preset](https://refrakt.md/themes/catppuccin): Soft pastel palette family — Latte (light) + Mocha (dark). Modern, well-documented, integrated chrome + canvas + syntax.
- [Dracula preset](https://refrakt.md/themes/dracula): The iconic dark theme — purple, pink, cyan, and green on near-black. Integrated chrome + canvas + syntax.
- [Gruvbox preset](https://refrakt.md/themes/gruvbox): Pavel Pertsev's warm retro palette — earthy oranges, deep greens, mustard yellows. The lineup's only warm palette.
- [Lumina](https://refrakt.md/themes/lumina): Refrakt's flagship theme — neutral default palette, two opt-in presets, and the design token contract.
- [Neutral default](https://refrakt.md/themes/neutral-default): Lumina's quiet warm-neutral palette — body colours, syntax palette, status palette, and typography.
- [Niwaki preset](https://refrakt.md/themes/niwaki): Japanese-garden syntax palette — wakaba, sakura, matsu, momiji, ishi. Composes with any chrome.
- [Nord preset](https://refrakt.md/themes/nord): Nord — Arctic, north-bluish colour palette with integrated canvas. Frost, Aurora, Polar Night, Snow Storm.
- [One Dark preset](https://refrakt.md/themes/one-dark): Atom's signature dark theme — blue-grey canvas with warm accents. The palette that defined a generation of modern editor themes.
- [Solarized preset](https://refrakt.md/themes/solarized): Ethan Schoonover's iconic 16-hue palette with mode-symmetric accents on flipped canvases. Light and dark from the same family.
- [Themes](https://refrakt.md/themes/themes-catalog): Refrakt's flagship Lumina theme plus the curated lineup of syntax presets — Nord, Dracula, Solarized, Catppuccin, Tokyo Night, One Dark, Gruvbox, Niwaki.
- [Tideline preset](https://refrakt.md/themes/tideline): Cream paper + maritime navy, with IBM Plex Sans and Plex Mono. The warm-branded preset.
- [Tokyo Night preset](https://refrakt.md/themes/tokyo-night): Neon-on-night palette by Enkia. Day + Storm canonical pair. The lineup's most aggressive role-splitter.

## Optional

- [llms-full.txt](https://refrakt.md/llms-full.txt): Full documentation content for comprehensive context