.. Tessella documentation master file, created by
   sphinx-quickstart on Mon Jul 13 17:32:26 2026.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Tessella documentation
======================

Tessella is a declarative, Flutter-inspired widget framework for building
user interfaces on top of `pygame-ce <https://pyga.me/>`_.

.. container:: tessella-hero

   .. figure:: /_static/images/examples/hud_overlay.png
      :alt: An in-game HUD overlay built with Tessella, showing health/mana/stamina bars, a minimap and a hotbar.

      An in-game HUD, built entirely out of widgets

   .. figure:: /_static/images/examples/skill_tree.png
      :alt: A skill tree built with Tessella, showing connected nodes and a hover-driven details panel.

      A skill tree, driven by reactive state

See the full :doc:`gallery` for more examples, or :doc:`widgets` for a
practical guide to each one.

Start with :doc:`installation` to set up your environment, then
:doc:`quickstart` to get a window on screen. The :doc:`tutorial` covers
Tessella's core concepts, :doc:`widgets` shows how to use each widget, and
the :doc:`API reference </api/modules>` documents every widget and style
class in full.

.. toctree::
   :maxdepth: 2
   :caption: Getting Started:

   installation
   quickstart
   tutorial
   concepts
   widgets
   gallery

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

   api/modules