Chirp 0.1.1

Released: February 15, 2026

CLI scaffolding, filesystem-based page routing, reactive block pipeline, SSE safety checks, form macros, and production deployment support.

Highlights

  • chirp CLI — chirp new, chirp run, chirp checkfor project scaffolding and validation
  • Filesystem routing — Layout-nested page discovery from directory structure
  • Reactive blocks — Structured reactive templates with derived state
  • SSE safety — Contract checks and event cross-reference validation
  • Form macros — Built-infield_errors, qsfilters and form field macros
  • Production — Pounce Phase 5 & 6 support, security headers, deployment docs

Added

CLI

  • chirp new <name> [--minimal]— Scaffold a project with app, templates, static assets, and tests
  • chirp run <app> — Start the dev server from an import string (e.g. chirp run myapp:app)
  • chirp check <app>— Validate hypermedia contracts from the command line

Routing & Pages

  • Filesystem-based page routing — Discover pages from directory structure with layout nesting
  • app.provide() — Dependency injection for request-scoped context providers
  • Safe target —hx-targetsafety for event-driven htmx elements

Templates

  • Template.inline() — Prototyping shortcut for string-based template rendering
  • InlineTemplate — Return type for inline templates (negotiation-aware)
  • Reactive block pipeline — Structured reactive templates with derived state
  • chirp-ui auto-detect — Auto-discovery of component library from template dirs

Forms

  • field_errors — Filter to extract validation messages for a single form field
  • qs — Filter to build URL query strings, omitting falsy values
  • form_or_errors() — Combines form_from() and ValidationErrorin one call
  • form_values() — Convert dataclass/mapping to dict[str, str]for re-population
  • Form macros —chirp/forms.html with text_field, textarea_field, select_field, checkbox_field, hidden_field

SSE & Real-Time

  • SSE safety checks — Contract validation for event streams
  • Event cross-reference — Validate SSE event types against handlers
  • Auto-registration —sse-swapattributes register handlers automatically

Production

  • Pounce Phase 5 & 6 — Production server feature support
  • Security headers middleware — X-Frame-Options, X-Content-Type-Options, Referrer-Policy
  • View transitions — OOB swap support for View Transitions API
  • Deployment docs — Production deployment guide

Examples

  • Pokedex — SQLite + migrations + full CRUD
  • Chat — Real-time chat with SSE
  • Production — Thank-you flow with production patterns
  • Accessibility — ARIA patterns and keyboard nav
  • API — JSON API example
  • RAG demo — Enhanced with share URLs, sync script, improved UI

Dependencies

  • kida-templates>=0.2.1— Template engine
  • bengal-pounce>=0.2.0— ASGI server

Upgrade Guide

  1. No breaking changes — All existing apps continue to work
  2. Optional — Usechirp new for new projects, chirp run instead of python -mfor dev
  3. Forms — Adoptform_or_errors()and form macros to reduce boilerplate