timetracker/REPOMAP.md

REPOMAP — Timetrack

Machine-readable overview of the repository. Every important file and directory with a one-line description. Update this file when adding new features or renaming paths.

Root

Path	Description
pubspec.yaml	Dependencies and Flutter config
analysis_options.yaml	Dart linter rules
AGENT.md	AI agent context — project rules and conventions
REPOMAP.md	This file — repository map

lib/

Path	Description
lib/main.dart	Entry point — ProviderScope wraps App
lib/app.dart	MaterialApp.router — theme, locales, router

lib/core/

Path	Description
lib/core/database/app_database.dart	Drift AppDatabase — tables, DAOs, connection setup
lib/core/router/app_router.dart	GoRouter provider — routes, bottom nav shell
lib/core/theme/app_theme.dart	AppTheme.light / AppTheme.dark (Material 3)
lib/core/l10n/	ARB localisation files (en, de, …)

lib/features/timer/

Path	Description
lib/features/timer/data/timer_repository.dart	TimerRepository interface
lib/features/timer/domain/	TimerState (freezed), TimerNotifier (Riverpod)
lib/features/timer/presentation/timer_screen.dart	Timer UI — start/stop, project picker, elapsed

lib/features/entries/

Path	Description
lib/features/entries/data/entries_repository.dart	EntriesRepository — CRUD TimeEntry
lib/features/entries/domain/	TimeEntry model (freezed), EntriesNotifier
lib/features/entries/presentation/entries_screen.dart	List of time entries, manual add/edit

lib/features/projects/

Path	Description
lib/features/projects/data/projects_repository.dart	ProjectsRepository — CRUD Project
lib/features/projects/domain/	Project model (freezed), ProjectsNotifier
lib/features/projects/presentation/projects_screen.dart	Project list, create/edit/archive

lib/features/reports/

Path	Description
lib/features/reports/data/reports_repository.dart	Report queries — aggregation by day/week/month
lib/features/reports/domain/	ReportData model, ReportsNotifier
lib/features/reports/presentation/reports_screen.dart	Day/week/month charts (fl_chart)

lib/features/settings/

Path	Description
lib/features/settings/presentation/settings_screen.dart	Language, theme, export, about

test/

Path	Description
test/features/timer/	Unit + widget tests for timer feature
test/features/entries/	Unit + widget tests for entries feature
test/features/projects/	Unit + widget tests for projects feature
test/features/reports/	Unit + widget tests for reports feature
test/core/	Database migration tests, router tests

.ai/

Path	Description
.ai/database.md	Full Drift schema, DAO list, migration strategy
.ai/architecture.md	ADRs — why Riverpod, Drift, go_router, feature-first
.ai/testing.md	Test patterns, mocktail conventions, coverage goals
.ai/features/timer.md	Timer state machine, restore-on-launch logic
.ai/features/reports.md	Report queries, fl_chart data format, filters
.ai/features/export.md	CSV/PDF/JSON schemas, share_plus flow

Generated Files (do not edit manually)

Pattern	Generator
**/*.g.dart	build_runner
**/*.freezed.dart	freezed
lib/core/router/app_router.g.dart	riverpod_generator