.. Duck documentation master file, created by
   sphinx-quickstart on Sat Aug 29 11:11:04 2026.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Documentation
==============

.. image:: https://cdn.jsdelivr.net/gh/duckframework/quirl@main/images/quirl-wordmark.svg
   :alt: Quirl Wordmark

A reusable UI component library for `Duck Framework's <https://duckframework.com>`_ Lively reactive system.

Build consistent, themeable interfaces in pure Python — no separate frontend toolchain, no JavaScript bundling, no build steps for your UI logic.


Github
-----------

- **Organization**: https://github.com/duckframework
- **Homepage**: https://github.com/duckframework/quirl

Stay tuned for more updates as we continue to enhance Duck's capabilities.


Author
-----------

- **Author**: Brian Musakwa
- **Email**: hello@duckframework.com

Contents
---------------
.. toctree::
   :maxdepth: 2
   :caption: Overview
   
   intro
   theming
   
.. toctree::
   :maxdepth: 2
   :caption: Quirl Components

   components/alert
   components/avatar
   components/badge
   components/carousel
   components/code
   components/demo
   components/divider
   components/documentor
   components/image
   components/skeleton
   components/spinner
   components/tag

.. toctree::
   :maxdepth: 2
   :caption: Reference

   changelog

.. toctree::
   :maxdepth: 2
   :caption: AI Assistance

   ai-guidelines

.. toctree::
   :maxdepth: 2
   :caption: API Documentation

   api/index