# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Build Commands
- Flutter: `cd flutt && flutter run` - run the Flutter app
- Flutter tests: `cd flutt && flutter test [test_file_path]` - run specific test
- Flutter linting: `cd flutt && flutter analyze` - analyze Dart code
- Flutter build: `cd flutt && flutter build [platform]` - build for specific platform
- Web: `cd web && npm run dev` - run Svelte dev server
- Web build: `cd web && npm run build` - build web app for production

## Code Style Guidelines
- Flutter/Dart: Follow Flutter lint rules in analysis_options.yaml
- Naming: camelCase for variables/methods, PascalCase for classes/enums
- Imports: Group imports by type (dart, flutter, third-party, project)
- Error handling: Use try/catch with specific error types
- Documentation: Add documentation comments for public APIs
- UI/Layout: Use responsive design principles (DashboardLayout widget)
- Types: Use strong typing, avoid dynamic when possible
- Architecture: Follow repository pattern for data access