Stati

Fast, minimal, and developer-friendly static site generator.

Get Started View Examples

Why Choose Stati?

Modern web development made simple with essential features that just work.

TypeScript First

Built with TypeScript from the ground up with defineConfig() helper.

Fast Development

Development server with live reload and incremental rebuilding.

ISG Support

Incremental Static Generation with intelligent caching and flexible invalidation.

Markdown & Templates

Powerful Markdown processing with Eta templating and hierarchical layouts.

Simple Configuration

Minimal configuration with sensible defaults and TypeScript IntelliSense.

Modern Tooling

CLI tools, project scaffolding, and development workflows built for efficiency.

Powerful Features

Modern static site generation with features that make development fast, intuitive, and type-safe

TypeScript-First Configuration

Built with TypeScript from the ground up. Get full type safety, IntelliSense autocomplete, and better debugging in your configuration files.

Full type inference with defineConfig()
IntelliSense autocomplete in VS Code
Catch configuration errors before build

Learn More

import { defineConfig } from '@stati/core';

export default defineConfig({
  site: {
    title: 'My Stati Site',
    baseUrl: 'https://example.com',
    defaultLocale: 'en-US',
  },

  markdown: {
    options: {
      html: true,
      linkify: true,
      typographer: true,
    },
  },

  isg: {
    enabled: true,
    ttlSeconds: 3600,
  },
});

Incremental Static Generation

Smart caching and dependency tracking means Stati only rebuilds what actually changed. Perfect for large sites with hundreds or thousands of pages.

Automatic dependency tracking
Selective rebuilds save time and resources
Flexible cache invalidation by path, tag, or age

Learn More

# Only rebuilds changed files
npm run build

# Invalidate specific paths
stati invalidate path:/blog/

# Invalidate by tag
stati invalidate tag:navigation

# Invalidate recent content (last 7 days)
stati invalidate age:7days

# Force full rebuild
stati build --clean

// Programmatic invalidation
import { invalidate } from '@stati/core';

await invalidate('tag:blog');
await invalidate('path:/about/ age:30days');

Powerful Eta Templates

Fast, lightweight templating with EJS-like syntax. Supports hierarchical layout nesting, reusable partials, and callable partials that accept custom data like components.

Hierarchical layout inheritance from parent directories
Reusable partials from any underscore-prefixed folder
Callable partials with stati.props for custom data

Learn More

<!-- Layout nesting: site/blog/layout.eta -->
<div class="blog-container">
  <aside>
    <%~ stati.partials.sidebar %>
  </aside>
  <main>
    <%~ stati.content %>
  </main>
</div>

<!-- Callable partials with custom data -->
<%~ stati.partials.card({
  title: 'My Post',
  description: 'A great article',
  url: '/blog/my-post'
}) %>

<!-- Inside _partials/card.eta -->
<article>
  <h3><%= stati.props.title %></h3>
  <p><%= stati.props.description %></p>
  <a href="<%= stati.props.url %>">Read</a>
</article>

Filesystem-Based Routing

Your directory structure is your site structure. No routing configuration needed - just create files and Stati handles the rest with clean URLs and unlimited nesting.

Zero configuration required
Underscored folders (_partials/) are excluded from routing
Override URLs with permalink in frontmatter

Learn More

# Basic routing
site/
├── index.md              → /
├── about.md              → /about/
└── blog/
    ├── index.md          → /blog/
    └── first-post.md     → /blog/first-post/

# Underscore exclusion
site/
├── _partials/            ❌ Not routed
│   └── header.eta
├── _components/          ❌ Not routed
│   └── card.eta
└── published.md          ✅ → /published/

# Permalink override
---
title: 'Featured Article'
permalink: '/featured/article/'
---
# Custom URL path!

Enhanced Markdown Pipeline

Powered by Markdown-It with tables, task lists, auto-linking, and smart typography. Extend with any markdown-it plugin for additional features like syntax highlighting.

Built-in tables, task lists, and auto-linking
Smart typography with quotes, em-dashes, and ellipses
Extensible with any markdown-it plugin

Learn More

---
title: 'My Blog Post'
date: '2024-01-15'
tags: ['stati', 'markdown']
---

# Enhanced Markdown

Write **bold**, *italic*, and `inline code`

```typescript
interface Config {
  title: string;
  baseUrl: string;
}
```

- [x] Completed task
- [ ] Pending task

Auto-link: https://stati.build

Get Started in Minutes

Create a new Stati site with a single command.

terminal

# Create a new Stati site with the interactive scaffolder

npx create-stati

View detailed installation guide