nitro-cli 1.0.5

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-ui - Programmatic HTML generation
• nitro-cli - Static site generator
• nitro-dispatch - Plugin system
• nitro-validate - Data validation

License

This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.