# Documentation

URL: /kida/docs/
Section: docs
Description: Documentation for the Kida Python template engine, including syntax, streaming, and Jinja2 migration

---

> For a complete page index, fetch /kida/llms.txt.

## Start Here

New to Kida? Start here to render HTML templates, learn the syntax, migrate from
Jinja2, build typed components, and integrate Kida into web frameworks or static site generators.

:::{cards}
:columns: 2
:gap: medium

:::{card} Get Started
:icon: arrow-clockwise
:link: ./get-started/
:description: Install Kida and render your first template
:::{/card}

:::{card} Learning Tracks
:icon: book
:link: /tracks/
:description: Goal-oriented journeys — Jinja2 migration, Chirp + Kida, framework integration
:::{/card}

:::{card} Build Typed Components
:icon: blocks
:link: /docs/usage/components/
:description: Defs, slots, scoped state, and static call-site validation
:::{/card}

:::{card} API Reference
:icon: bookmark
:link: ./reference/api/
:description: Complete API documentation with examples
:::{/card}

:::{/cards}

## Learn Kida

Master template syntax, rendering patterns, framework integration, and migration paths.

:::{cards}
:columns: 2
:gap: medium

:::{card} Syntax
:icon: code
:link: ./syntax/
:description: Variables, control flow, filters, inheritance
:::{/card}

:::{card} Components
:icon: blocks
:link: ./usage/components/
:description: Typed props, named slots, scoped slots, and validation
:::{/card}

:::{card} Usage
:icon: terminal
:link: ./usage/
:description: Loading templates, contexts, escaping, errors
:::{/card}

:::{card} Framework Integration
:icon: puzzle
:link: ./usage/framework-integration/
:description: Block rendering, introspection, adapters for Chirp and Bengal
:::{/card}

:::{card} Extending
:icon: starburst
:link: ./extending/
:description: Custom filters, tests, globals, and loaders
:::{/card}

:::{card} Tutorials
:icon: notepad
:link: ./tutorials/
:description: Step-by-step guides for common scenarios and Jinja2 migration
:::{/card}

:::{/cards}

## Look It Up

Technical specifications, troubleshooting, and design details.

:::{cards}
:columns: 2
:gap: medium

:::{card} Reference
:icon: bookmark
:link: ./reference/
:description: API, filters, tests, and configuration
:::{/card}

:::{card} Troubleshooting
:icon: alert-triangle
:link: ./troubleshooting/
:description: Common errors and how to fix them
:::{/card}

:::{card} Advanced
:icon: cpu
:link: ./advanced/
:description: Compiler, profiling, coverage, sandboxing, and free-threading
:::{/card}

:::{card} About
:icon: info
:link: ./about/
:description: Architecture, performance, comparisons, and design philosophy
:::{/card}

:::{/cards}