Back to themes

SupportGenix Docs

The free Astro theme for building fast, beautiful documentation sites. MDX, Pagefind search, and Tailwind CSS, all built in.


Cost

Free


Created by
HasThemes

SupportGenix Docs is a free, production-ready Astro theme for building beautiful documentation sites, help centers, and knowledge bases. It's designed to help you launch polished documentation in minutes — no configuration required, no backend needed, and no hidden costs.


Built on Astro 6 with static output, MDX content collections, Tailwind CSS 4, and Pagefind search, this theme gives you everything you need to create a modern, fast, and SEO-ready documentation site.


━━━━━━━━━━━━━━━━━━━━━━━━


Key Features


  • Beautiful 3-Column Layout — Sidebar navigation, rich MDX content area, and automatic table of contents for a professional docs experience.
  • Built-In Full-Text Search — Powered by Pagefind with a JSON fallback. Zero configuration, works offline, and indexes every article at build time.
  • Automatic Category Organization — Drop MDX files into folders and the theme handles sidebar navigation, breadcrumbs, and related articles automatically.
  • MDX Content Collections — Write in Markdown with embedded components. Includes Zod schema validation for type-safe frontmatter.
  • SEO-Ready Out of the Box — Canonical URLs, Open Graph tags, Twitter cards, JSON-LD structured data, and automatic sitemap generation.
  • Fully Responsive — Mobile-first design built with Tailwind CSS 4 design tokens. Looks great on phones, tablets, and desktops.
  • Tailwind CSS 4 Customization — Change colors, fonts, and styles through a single global.css file with CSS custom properties and design tokens.
  • Alpine.js Interactivity — Lightweight client-side interactions for mobile menus, search dropdowns, and article feedback without heavy JavaScript.
  • Article Feedback UI — Built-in "Was this helpful?" component with localStorage persistence. No backend or database required.
  • Related Articles — Automatically suggests related content based on category, with fallback to recent articles from across the site.



━━━━━━━━━━━━━━━━━━━━━━━━


Perfect For


Product documentation, software help centers, knowledge bases, API documentation, internal wikis, developer guides, and customer support portals.


━━━━━━━━━━━━━━━━━━━━━━━━


Tech Stack


• Astro 6 (static output)

• MDX with content collections

• Tailwind CSS 4

• Alpine.js

• Pagefind (full-text search)

• @astrojs/sitemap

• @astrojs/mdx

• Self-hosted Poppins font via @fontsource


━━━━━━━━━━━━━━━━━━━━━━━━


Quick Start


1. Clone the repository from GitHub

2. Run npm install

3. Run npm run dev

4. Start writing docs in src/content/docs/


That's it. The theme automatically generates navigation, categories, breadcrumbs, and related articles from your MDX files.


━━━━━━━━━━━━━━━━━━━━━━━━


Free and Open Source


SupportGenix Docs is 100% free and open source under the ISC license. No hidden fees, no premium tiers, no locked features. You get the complete theme with full customization rights.


Need a WordPress-based support and knowledge base solution? Check out SupportGenix for WordPress at supportgenix.com — a full-featured support ticket and knowledge base plugin with built-in ticketing, email piping, AI support, and more.


━━━━━━━━━━━━━━━━━━━━━━━━


Resources