Docs Examples Reference Community Blog

Theme

Version

GitHub PyPI Discord

Docs Examples Reference Community Blog

Docs

Home

Getting started

Install Citry
Your first component
Use data in components
Build a page from components
Add flexible content
Add browser behavior
Connect components in the browser
Serve a page with FastAPI
Call Python from a click
Events state
Handle and validate a form
Replace part of the page from Python

Template syntax

Expressions
Dynamic attributes
Control flow
Comments
Nested templates

Concepts

Components
Client interactivity
Registration and autodiscovery
Subclassing components
Slots
Typing and validation
Rendering
HTML attributes
Provide and inject
Error boundaries

Events

Server events
Keep state between calls
Handle and validate forms
Bind events in templates
Update the page from a handler
Use event routes directly

Advanced

Dynamic components
JS and CSS dependencies
Alpine runtime
HTML fragments
Performance
Caching
Extensions
Component hooks
Sharing components
Testing components
Command line

Guides

Web frameworks
Troubleshooting
Hot reload
Migrate from Component.View
Migrate from django-unicorn
Migrate from Tetra
Migrate from livecomponents
Events migration parity

About

Compatibility
Benchmarks
Security

Overview
v0.3.0 (2026-07-28)
v0.2.0
v0.1.0 (2026-06-30)

Docs / Release notes

Release notes

What changed in each version of citry, newest first. Pick a version for its full notes.

v0.3.0 (2026-07-28)
v0.2.0
v0.1.0 (2026-06-30)

← Previous Security Next → v0.3.0 (2026-07-28)

Citry version: 0.3.0

Popular pages

Getting started
Components
Slots
API reference
Examples

↑↓ navigate ↵ select esc close