Flutter App Structure

Entry Flow

main.dart → AppThemeProvider → MaterialApp → AppRoot → Screen

Folder	Purpose
`screens/`	Full-screen views (splash, dashboard, overheat)
`widgets/`	Reusable components (stat_box, navigator)
`services/`	Singletons with business logic
`theme/`	Color definitions and runtime theme switching

All services use singleton pattern with ServiceName.instance.

Service	Role
`ConfigService`	Loads `config.json`, exposes settings
`PiIO`	Pi hardware interface (CPU temp, future GPIO)
`OverheatMonitor`	Polls temp, fires callback when threshold exceeded
`ThemeService`	Dark/bright mode state, notifies listeners
`TestFlipFlopService`	Debug: toggles theme + navigator emotion every 2s

AppColors — static color constants (dark/bright variants), auto-generated from JSON
AppTheme — InheritedWidget providing runtime colors via AppTheme.of(context)
ThemeService — singleton holding current mode, call setDarkMode(bool) or toggle()

Usage in widgets:

final theme = AppTheme.of(context);
backgroundColor: theme.background,
color: theme.foreground,

AppRoot manages which screen is visible: