# AGENTS.md
For guidance on working with this repository, see the [`.ai/`](.ai/) directory:
- [COMMANDS.md](.ai/COMMANDS.md) - Build, test, lint
- [ARCHITECTURE.md](.ai/ARCHITECTURE.md) - Backend, callbacks, layout
- [RENDERER.md](.ai/RENDERER.md) - Frontend, React, Redux
- [COMPONENTS.md](.ai/COMPONENTS.md) - Component system
- [TESTING.md](.ai/TESTING.md) - Testing patterns
- [TROUBLESHOOTING.md](.ai/TROUBLESHOOTING.md) - Common issues
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Required Reading
**At the start of each session, read the documentation in `.ai/` before making changes:**
1. `.ai/COMMANDS.md` - Build, test, lint commands
2. `.ai/ARCHITECTURE.md` - Backend, callbacks, pages, assets, errors, background callbacks, Jupyter, config, stores, async, security
3. `.ai/RENDERER.md` - Frontend, crawlLayout, Redux store, clientside API, component API
4. `.ai/COMPONENTS.md` - Component system, generation, resources
5. `.ai/TESTING.md` - Testing framework, fixtures, patterns, type compliance
6. `.ai/TROUBLESHOOTING.md` - Common errors and solutions
## Project Overview
Dash is a Python framework for building reactive web-based data visualization applications. Built on Plotly.js, React, and Flask.
## Key Files
- `dash/dash.py` - Main Dash app class, layout, callbacks, routing
- `dash/_callback.py` - `@callback` decorator and execution
- `dash/dependencies.py` - `Input`, `Output`, `State`, wildcards
- `dash/development/base_component.py` - Component base class, `to_plotly_json()`
- `dash/dash-renderer/` - TypeScript/React frontend
- `components/` - Component packages (dcc, html, table)
