nitro-cli 1.0.0

Build static sites with Python code instead of templates

Nitro CLI

A static site generator that lets you build websites using Python and nitro-ui.

Features

• Python-Powered - Write pages in Python with nitro-ui instead of template languages
• Live Reload - Development server with automatic browser refresh
• Incremental Builds – Only rebuild changed pages
• Dynamic Routes – Generate pages from data with [slug].py pattern
• Image Optimization – Responsive images with WebP/AVIF conversion
• Islands Architecture - Partial hydration for interactive components
• One-Click Deploy – Netlify, Vercel, or Cloudflare Pages

Installation

pip install nitro-cli

AI Assistant Integration

Add Nitro CLI knowledge to your AI coding assistant:

npx skills add nitrosh/nitro-cli

This enables AI assistants like Claude Code to understand Nitro CLI and generate correct nitro-ui code.

Quick Start

nitro new my-site
cd my-site
nitro dev

Visit http://localhost:3000. Build for production with nitro build.

Writing Pages

Pages are Python files in src/pages/ that export a render() function:

# src/pages/index.py
from nitro_ui import HTML, Head, Body, H1, Title
from nitro import Page

def render():
    return Page(
        title="Home",
        content=HTML(
            Head(Title("Home")),
            Body(H1("Welcome!"))
        )
    )

Output paths mirror the file structure: src/pages/about.py → build/about.html

Dynamic Routes

Generate multiple pages from data using [param].py naming:

# src/pages/blog/[slug].py
from nitro import Page
from nitro_datastore import NitroDataStore

def get_paths():
    data = NitroDataStore.from_file("src/data/posts.json")
    return [{"slug": p["slug"], "title": p["title"]} for p in data.posts]

def render(slug, title):
    return Page(title=title, content=...)

Commands

Command	Description
nitro new <name>	Create new project
nitro dev	Start dev server with live reload
nitro build	Build for production
nitro preview	Preview production build
nitro clean	Remove build artifacts
nitro deploy	Deploy to hosting platform

Run nitro <command> --help for options.

Configuration

# nitro.config.py
from nitro import Config

config = Config(
    site_name="My Site",
    base_url="https://mysite.com",
    renderer={"minify_html": True}
)

Ecosystem

Nitro isn’t just one library – it’s a growing toolkit of focused building blocks you can mix and match to ship faster:

• nitro-ui - Generate clean, reusable HTML with a lightweight, developer-friendly API
• nitro-datastore - Load and access data effortlessly using simple dot-notation paths
• nitro-dispatch - A flexible plugin system to extend features without touching core code
• nitro-validate - Fast, reliable data validation to keep your inputs and payloads rock-solid

License

MIT