sourcey
Submit

agents:SKILL.mdmcp.jsonopenapi.yml

Docs from the source.

sourcey turns OpenAPI, MCP, Doxygen, godoc, rustdoc, and Markdown into one static HTML site that looks the part. Guides, changelog, roadmap, and llms.txt ship from the same build. Open source and free.

Get startedLive demo →
Explore live demosourcey demo. Cheese Store API documentation.
Take it home with you
Get started

Empty directory to shipped docs in three commands.

init scaffolds the project, dev gives you hot reload, build emits static HTML.

Terminal
$ npx sourcey init
› Created sourcey.config.ts
› Added 3 example pages
✓ Ready
$ sourcey dev
› Parsing openapi.yaml (42 endpoints)
› Rendering 12 pages
✓ sourcey v3.6
http://localhost:4400
Ready in 1.2s
$ sourcey build
› Writing 50 pages to dist/
✓ Built in 1.8s
  1. 01

    Configure

    Configuration Reference

    Point it at your OpenAPI spec, MCP server, or markdown. One TypeScript file, type-checked with full autocomplete.

    npx sourcey init
  2. 02

    Write

    Writing Pages

    Markdown with rich components: steps, cards, accordions, code blocks. Guides alongside your API reference.

    sourcey dev
  3. 03

    Ship

    Deploying

    Static HTML with no runtime. Deploy to GitHub Pages, Vercel, S3, or anywhere you serve files.

    sourcey build
Built in

Built in, not bolted on.

Dark mode, search, themes, OG images, llms.txt. No plugin hunt, no add-on pricing.

Looks great either way.

Semantic design tokens, light and dark logo variants, localStorage persistence. Every component designed for both modes.

My API
Search...
DocsAPI ReferenceChangelog
Getting Started
Introduction
Quick Start
Authentication
Concepts
Webhooks
Directives
Introduction

Welcome to the API documentation. This guide covers authentication, endpoints, and best practices.

$ npm install @myapi/sdk
+ @myapi/sdk@2.1.0
Quick Start
GETPOSTDELETE

Search that ships with the site.

Client-side fuzzy search across every page and API operation. Cmd+K, start typing. Works offline, no server required.

⌘K
↑↓ navigate↵ open

Technical docs can look this good.

Four themes give you a starting point. Set your own fonts and colours, then use CSS for the details.

MailSchema uses the reader theme for its specification, inside an Astro site. Chapter navigation and a table of contents keep a long document easy to follow.

Read the MailSchema specification →
mailschema.org/specification
MailSchema specification in Sourcey’s reader theme, with chapter navigation and a table of contents
MailSchema · Reader theme · Custom fonts and colours

100 in all four Lighthouse categories.

The live Cheese Store quickstart scored 100 for performance, accessibility, best practices, and SEO in a mobile Lighthouse 13.5 audit on 8 October 2026. It has no video embed. Scores can vary between runs and pages. Run a fresh audit.

Lighthouse Report
100
Performance
100
Accessibility
100
Best Practices
100
SEO
Features

Six formats in. One site out.

Search, themes, and context exports, all from one build.

Generate from what you have

OpenAPI, MCP, Doxygen XML, godoc, rustdoc, Markdown. Point sourcey at any of them and it renders the reference.

  • OpenAPI 2.0 through 3.2

    Full spec coverage including 3.2's QUERY operations, hierarchical tags, and response summaries. Endpoints, schemas, and auto-generated code samples in ten languages, from cURL to Rust.

  • MCP server docs

    Tools, resources, and prompts rendered as browsable reference. JSON-RPC, TypeScript, and Python code samples.

  • C++ and Java via Doxygen

    Feed in Doxygen XML output and get modern, searchable API docs. Works with Moxygen for Markdown-based rendering.

  • Go and Rust, natively

    Go package docs from the Go toolchain, no Doxygen detour, and Rust crate docs from rustdoc JSON via the sourcey-rustdoc binary.

  • Markdown and MkDocs

    Rich Markdown components (steps, cards, accordions, tabbed code), plus existing mkdocs.yml sites brought across whole: nav, snippets, admonitions, assets.

Feels like the rest of your stack

TypeScript config, Vite dev server, instant feedback.

  • TypeScript config

    sourcey.config.ts with defineConfig(). Full autocomplete, type checking. One file defines your entire docs site.

  • Vite dev server

    SSR hot reload on every component and CSS change. Spec and markdown changes trigger instant refresh.

  • Instant search

    Client-side fuzzy search across all pages and API operations. Cmd+K to find anything. Works offline.

  • Install anywhere

    npx sourcey with no global install, or install once via Homebrew, Docker, or Nix.

  • Builds in CI

    One build command drops into GitHub Actions or any pipeline. The docs rebuild from source on every push.

Your output, your hosting

Control how it looks and where it goes. Four theme presets, design tokens, static HTML output, your deploy target.

  • Static HTML output

    Zero framework runtime shipped. Deploy to GitHub Pages, Vercel, S3, anywhere.

  • Four theme presets

    Default sidebar + TOC. Minimal single column. API-first three-column. Reader for long-form documents. Your fonts, colours, and CSS on top.

  • Dark mode

    Semantic design tokens, light/dark logo variants, localStorage persistence. Both modes designed in from day one.

  • OG image cards

    Social preview images generated at build time, one per page, from the same source.

  • Context exports

    Auto-generate llms.txt and llms-full.txt alongside your HTML as alternate views of the same documentation graph.

Compare

How Sourcey compares.

All comparisons →

Compare the build, the finished site, and the work involved in switching.

Writing

All essays →

Own your docs.

Open source under AGPL-3.0. Fork it or run it on your own infrastructure.

View on GitHubRead the docs
Fork the demo →