Stati

TypeScript-first static site generator with zero-config setup, fast esbuild bundling, and file-based routing.

Get Started Core Concepts

Why Choose Stati?

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

TypeScript First

Type-safe config and built-in esbuild compilation for your client-side code.

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

Sensible defaults that work out of the box, with powerful customization when you need it.

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

Full TypeScript Support

Built with TypeScript from the ground up. Type-safe configuration with IntelliSense, plus built-in esbuild compilation for your client-side TypeScript code.

Full type inference with defineConfig() in stati.config.ts
Built-in esbuild compilation with automatic script injection
Dev mode: source maps & hot reload. Prod mode: minification & hashing
Multiple bundles with per-page targeting via include/exclude patterns

Learn More

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

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

  typescript: {
    enabled: true,
    bundles: [
      {
        // Included on all pages by default
        entryPoint: 'main.ts',
      },
      {
        // Only included on docs pages
        entryPoint: 'docs.ts',
        include: ['/docs/**'],
      },
    ],
  },
});

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

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