.. _dashboard_ref:

Dashboard
=========

The interactive Dash dashboard used to explore cumulative factor contributions, percentage
decomposition, and summary statistics.

.. note::

   ``dashboard`` is **not** imported from the ``kaxanuk.attribution_analysis`` base namespace, to
   avoid loading Dash on every import of the package. It is imported lazily inside
   :func:`~kaxanuk.attribution_analysis.performance_attribution.main` only when
   ``launch_dashboard=True``. To use it directly:
   ``from kaxanuk.attribution_analysis.dashboard.attribution_dashboard import ...``

What you'll find here:

- :ref:`dashboard_core_ref` – the main dashboard app factory
- :ref:`dashboard_layouts_ref` – page layout definitions
- :ref:`dashboard_components_ref` – reusable Dash components
- :ref:`dashboard_callbacks_ref` – interactive callback definitions
- :ref:`dashboard_styling_ref` – chart colors, constants, and CSS styles
- :ref:`dashboard_visualizers_ref` – Plotly chart-creation functions

.. toctree::
   :maxdepth: 2
   :hidden:

   dashboard/core
   dashboard/layouts
   dashboard/components
   dashboard/callbacks
   dashboard/styling
   dashboard/visualizers