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
- Live Demo: astro.supportgenix.com
- GitHub Repository: github.com/supportgenix/supportgenix-docs
- Documentation: Included with the theme
- WordPress Version: supportgenix.com