Features
Everything You Need to Publish, Nothing You Don't
A static site generator built for writers and engineers who care about performance, flexibility, and control over every byte that ships.
Advanced Markdown Processing
YAML frontmatter with 19+ date format support. Write content in Markdown and let Static handle the rest.
Plugin-Based Shortcode System
YouTube, Vimeo, Mermaid diagrams, code tabs, callouts, table of contents, and article links. Extend with your own shortcodes.
Multi-Site Generation
Generate multiple sites from a single Static installation. Shared templates, shared shortcodes, independent content.
Archive System
Time-based content archiving with separate pagination. Older content stays accessible without cluttering the main feed.
Tags and Topics
Tag and topic-based content organization with automatic slug generation. Browsable taxonomy pages generated at build time.
Syntax Highlighting
Pygments-powered highlighting for 30+ languages. Beautiful code blocks with zero client-side overhead.
Mermaid Diagram Rendering
Build-time SVG conversion for Mermaid diagrams. No client-side JavaScript required for diagram rendering.
Automatic Image Optimization
WebP conversion with 25-35% size reduction. Responsive <picture> element generation with WebP source and original fallback.
Flask Admin Interface
Authentication, content management, and real-time WebSocket updates. Manage your sites from a browser.
File Watching with Live Reload
1-second debounce and automatic browser refresh via WebSocket. Edit, save, see. No manual reload needed.
Semantic Search
Voyage AI embeddings with vector index management. Search by meaning, not just keywords. Lambda-based serverless deployment.
AI Content Detection
Sapling AI integration with configurable thresholds. Detect AI-generated content before it ships.
React Component Export
Export content as React components for integration with modern frontends. Static content, dynamic delivery.
Multi-Stage AWS Deployment
Deploy to S3 with automatic CloudFront cache invalidation. Staging and production environments from a single command.
Full Infrastructure Provisioning
S3 buckets, ACM certificates, CloudFront distributions, and Route 53 DNS records. Provision everything from the CLI.
Jinja2 Template Engine
Full access to structured content — headings, paragraphs, images, and metadata — inside your templates. Complete control over output.
SCSS Compilation
Full SCSS support with @import resolution. Write modular stylesheets that compile to optimized CSS at build time.
Custom HTML and JS Minification
Zero-dependency minification for HTML and JavaScript. No external tools, no bloated node_modules. Just smaller output.
Incremental Builds
Valkey/Redis dependency tracking with smart rebuilds. Only regenerate what changed. Fast builds even on large sites.
Responsive Picture Elements
Automatic <picture> generation with WebP source and fallback. Every image is served in the optimal format for the browser.
Configurable CSS Classes
Every HTML element can be styled via configuration. No template editing required for basic design changes.
Serverless Search
Lambda-based search deployment with Voyage AI embeddings. Fast, scalable, and cost-effective semantic search.
Docker Compose Dev Environment
PostgreSQL and Valkey included. One command to spin up the full development stack.
MCP Server
Model Context Protocol server for AI/LLM integration. Structured content access for Claude Code and other AI assistants.
How It Works
From Markdown to Production
Write
Author content in Markdown with YAML frontmatter. Use shortcodes for rich embeds, diagrams, and interactive elements.
Build
Static processes Markdown, optimizes images to WebP, compiles SCSS, renders Jinja2 templates, and minifies output.
Iterate
Incremental builds detect changes via Valkey dependency tracking and rebuild only what's needed. Live reload keeps your browser in sync.
Deploy
Push to S3 and CloudFront with a single command. Automatic cache invalidation ensures visitors see the latest content immediately.
Technical Specifications
Under the Hood
Core
- Python 3.9+
- Flask web framework
- Jinja2 template engine
- SQLAlchemy ORM
- PostgreSQL database
- Valkey / Redis caching
Frontend
- React 19 admin interface
- Real-time WebSocket updates
- SCSS compilation
- Pygments syntax highlighting
- Mermaid SVG rendering
Infrastructure
- AWS S3 static hosting
- CloudFront CDN
- ACM certificate provisioning
- Route 53 DNS
- Lambda serverless search
- ECR container registry
Quality
- Docker Compose dev environment
- MCP server integration
- Multi-site generation
Development
100% Built by Claude
Narrative was built entirely by Claude (Anthropic) working alongside a single human supervisor. Every line of code, every test, every deployment: AI-authored with human direction.