What is Specra?

Specra is a modern documentation framework that makes writing and publishing technical documentation actually enjoyable. Built on top of SvelteKit, MDX, and Tailwind CSS, it gives you the polished look and feel of premium documentation platforms like Mintlify, but you host it yourself.

If you've ever struggled with clunky documentation tools or paid way too much for hosted solutions, Specra is here to change that. Write your docs in Markdown, add interactive components when you need them, and deploy anywhere you want.

Why We Built Specra

Documentation shouldn't be hard. You should be able to focus on writing great content, not wrestling with configuration files or fighting against your tools. Here's what we believe:

Content comes first. Drop your MDX files into a folder, and Specra handles the rest. No manual routing, no navigation setup, no build configuration headaches.

Developer experience matters. Hot reload means you see changes instantly. TypeScript keeps you safe. The component library is there when you need it, invisible when you don't.

Performance is non-negotiable. Pre-rendered pages, edge caching, optimized images. Your docs load fast, always.

Flexibility over lock-in. Deploy to Vercel, GitHub Pages, Netlify, or anywhere that runs Node.js or serves static files. You own your content and your infrastructure.

Key Features

The Stack

We built Specra on proven, modern technologies:

• SvelteKit with file-based routing for optimal performance and developer experience
• MDX so you can write Markdown with Svelte components mixed in
• Tailwind CSS for styling that's both powerful and maintainable
• MeiliSearch for search that's fast and forgiving of typos
• TypeScript because type safety saves time and sanity

What You Get

When you use Specra, you get a complete documentation system:

Rich Content Components Callouts, tabs, code blocks with syntax highlighting, cards, accordions, steps, diagrams with Mermaid, math equations with KaTeX, and more.

Automatic Navigation Your folder structure becomes your sidebar. Add a _category_.json file to customize sections. That's it.

Smart Features Reading time estimates, last updated timestamps, tag support, breadcrumbs, responsive table of contents with scroll tracking.

API Documentation Generate beautiful API references from OpenAPI specs, Postman collections, or Specra's own format. Interactive playground included.

Multi-Version Support Maintain docs for v1, v2, v3 simultaneously. Version switcher lets users jump between them instantly.

Search That Works Full-text search with keyboard shortcuts (⌘K or Ctrl+K). Works offline with local search or scales up with MeiliSearch.

Theme System Respects system preferences, supports manual dark/light toggle, customizable via CSS variables.

Production Ready SEO optimization, accessibility baked in, security headers, performance monitoring, CI/CD examples.

How It Works

Specra follows a simple philosophy: you write, we handle the rest.

Who Should Use Specra?

Specra is perfect for:

• Open source maintainers who need professional docs without the hosting fees
• Startups that want great documentation without enterprise pricing
• API developers who need versioned docs and interactive API references
• Technical writers who prefer Markdown over WYSIWYG editors
• Teams that want docs living in the same repo as their code

Architecture

Specra is composed of three packages that work together:

specra (SDK) — The core library installed as a dependency in every Specra site. Provides Svelte layout components (Header, Sidebar, Footer, TabGroups), MDX processing, configuration types, theming, and versioning logic.

create-specra (CLI) — The scaffolding tool that generates new documentation projects. Offers three templates (Minimal, Book Docs, JBrains Docs), each with different layouts and sample content. Run npx create-specra to get started.

specra-docs (this site) — The official documentation and SaaS platform at specra-docs.com. Built with the Specra SDK, it also includes authentication (Auth.js), subscription billing (Stripe + M-Pesa), a user dashboard, and an admin panel. The SaaS features are specific to this site and are not part of the SDK.

specra (SDK)  ←  Core components & config
     ↑
create-specra (CLI)  ←  Scaffolds new projects using the SDK
     ↑
specra-docs  ←  Official site + SaaS layer

Users of the SDK can build free, self-hosted documentation sites without any billing or authentication features.

Ready to Start?

Jump into the Getting Started guide and have your first documentation site running in under 5 minutes.