Generators
Generators are the engines that transform your blog.json into beautiful static websites. Use our official generator or create your own.
Official Generator
@jsonblog/generator-boilerplate
A clean, minimal reference implementation with IBM Plex Mono typography.
Features
- • Responsive design with mobile-first approach
- • IBM Plex Mono monospace typography
- • Support for tags and categories
- • RSS feed generation
- • Markdown content rendering
- • AI-generated post indicators
- • Fast static HTML output
Installation
npm install -g @jsonblog/generator-boilerplateCreating Custom Generators
Build your own generator to completely customize your blog's appearance and functionality.
1. Create a Generator Package
A generator is a Node.js module that exports a function accepting blog data and options:
import type { BlogData } from '@jsonblog/schema';
export async function generate(
data: BlogData,
options: { outputDir: string }
): Promise<void> {
// Transform blog.json into HTML files
// Write to options.outputDir
}2. Use Any Template Engine
Choose your favorite templating solution:
- • Handlebars (used in boilerplate)
- • EJS
- • Pug
- • React with SSG
- • Plain JavaScript template literals
3. Register Your Generator
Publish to npm and install globally:
npm install -g your-jsonblog-generatorCommunity Generators
More generators coming soon! Building one? Let us know on GitHub.
Contribute on GitHub