GRAD
GRAD is an ultra-fast and lightweight static site generator written in TypeScript and powered by Bun.
It converts Markdown content into clean, fast static HTML while keeping the development workflow simple and transparent.
GRAD focuses on speed, minimalism, and hackability, making it easy for developers to understand the entire build pipeline.
The project is designed for people who prefer small, understandable tools instead of complex frameworks.
Core Philosophy
Grad SSG follows a few and simple core principles:
- Minimal dependencies
- Readable source code
- Predictable build pipeline
- Fast development feedback
Instead of hiding complexity behind large abstractions, Grad SSG keeps its internal architecture clear and inspectable.
Techical Features
- Markdown → HTML page generation
- Simple template system
- Static assets pipeline
- Development server with Hot Reload
- Incremental builds for faster rebuilds
- File watcher for automatic rebuilds
- Built-in WebSocket live reload
- Multi-size favicon support
- Content collections
- Automatic collection indexes
- JSON content index generation
- Built-in client-side Search support
How Grad SSG Works?
GRAD processes a website in 3 (three) main stages:
1. Content Parsing
Markdown files located in the content/ directory are parsed and converted into HTML pages.
2. Template Rendering
Pages are injected into HTML templates to produce the final document structure.
3. Site Output
The generated website is written to the public/ directory along with static assets.
This process is optimized using incremental builds, allowing Grad SSG to skip unchanged webpages during rebuilds.
Development Server
Grad SSG includes a development server designed for fast iteration, and its features include:
- Automatic rebuilds
- File watching
- WebSocket "live reload"
- Browser instantly refreshes after content changes
This creates a smooth workflow when editing Markdown or templates.
Design Goals
Grad SSG aims to be 4 things:
- Small
- Fast
- Predictable
- Easy to extend
Rather than becoming a large framework, Grad SSG focuses on being a clean foundation for static website workflows.
Software License
MIT Open Source License, also known as the "MIT License".