Initialize Riverpod state management and responsive utilities (#271)

* feat: Initialize Riverpod state management and responsive utilities

* Remove redundant dashboard team name provider

* Expose theme via Riverpod

* Add Freezed based dashboard state

* Adopt Riverpod codegen and reorganize models

Author: dhruvi-16-me

lib/core/responsive/breakpoints.dart

@@ -0,0 +1,18 @@
+/// Centralized layout breakpoints for Ell-ena responsive layouts.
+///
+/// Widths are logical pixels (same as [MediaQuery.sizeOf] width).
+class Breakpoints {
+  Breakpoints._();
+  /// Maximum width (exclusive) for [DeviceSize.mobile].
+  static const double mobileMax = 600;
+
+  /// Maximum width (exclusive) for [DeviceSize.tablet].
+  static const double tabletMax = 1024;
+}
+
+/// Device size bucket derived from layout width.
+enum DeviceSize {
+  mobile,
+  tablet,
+  desktop,
+}

lib/core/responsive/responsive_layout.dart

@@ -0,0 +1,38 @@
+import 'package:flutter/material.dart';
+
+import 'breakpoints.dart';
+import 'responsive_utils.dart';
+
+/// Selects [mobile], [tablet], or [desktop] child based on available width.
+///
+/// Uses [LayoutBuilder] so it reacts to window resizes (web/desktop) without
+/// requiring a full app rebuild.
+class ResponsiveLayout extends StatelessWidget {
+  const ResponsiveLayout({
+    super.key,
+    required this.mobile,
+    this.tablet,
+    required this.desktop,
+  });
+
+  final Widget mobile;
+  final Widget? tablet;
+  final Widget desktop;
+
+  @override
+  Widget build(BuildContext context) {
+    return LayoutBuilder(
+      builder: (context, constraints) {
+        final width = constraints.maxWidth;
+        switch (ResponsiveUtils.deviceSizeForWidth(width)) {
+          case DeviceSize.mobile:
+            return mobile;
+          case DeviceSize.tablet:
+            return tablet ?? desktop;
+          case DeviceSize.desktop:
+            return desktop;
+        }
+      },
+    );
+  }
+}

lib/core/responsive/responsive_utils.dart

@@ -0,0 +1,44 @@
+import 'package:flutter/material.dart';
+
+import 'breakpoints.dart';
+
+/// Layout helpers based on screen width.
+class ResponsiveUtils {
+  ResponsiveUtils._();
+  static DeviceSize deviceSizeForWidth(double width) {
+    if (width < Breakpoints.mobileMax) return DeviceSize.mobile;
+    if (width < Breakpoints.tabletMax) return DeviceSize.tablet;
+    return DeviceSize.desktop;
+  }
+
+  static DeviceSize deviceSizeOf(BuildContext context) {
+    return deviceSizeForWidth(MediaQuery.sizeOf(context).width);
+  }
+
+  static bool isMobile(BuildContext context) =>
+      deviceSizeOf(context) == DeviceSize.mobile;
+
+  static bool isTablet(BuildContext context) =>
+      deviceSizeOf(context) == DeviceSize.tablet;
+
+  static bool isDesktop(BuildContext context) =>
+      deviceSizeOf(context) == DeviceSize.desktop;
+
+  static bool isMobileWidth(double width) =>
+      deviceSizeForWidth(width) == DeviceSize.mobile;
+
+  static bool isTabletWidth(double width) =>
+      deviceSizeForWidth(width) == DeviceSize.tablet;
+
+  static bool isDesktopWidth(double width) =>
+      deviceSizeForWidth(width) == DeviceSize.desktop;
+}
+
+/// Convenience extensions on [BuildContext] for responsive checks.
+extension ResponsiveContext on BuildContext {
+  DeviceSize get deviceSize => ResponsiveUtils.deviceSizeOf(this);
+
+  bool get isMobile => ResponsiveUtils.isMobile(this);
+  bool get isTablet => ResponsiveUtils.isTablet(this);
+  bool get isDesktop => ResponsiveUtils.isDesktop(this);
+}

lib/main.dart

@@ -1,11 +1,14 @@
 import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart'
+    hide ChangeNotifierProvider;
 import 'package:provider/provider.dart';
 import 'screens/splash_screen.dart';
 import 'screens/home/home_screen.dart';
 import 'screens/chat/chat_screen.dart';
 import 'services/navigation_service.dart';
 import 'services/supabase_service.dart';
 import 'services/ai_service.dart';
+import 'providers/theme_provider.dart';
 import 'theme/theme_controller.dart';
 import 'theme/app_themes.dart';
 
@@ -23,20 +26,25 @@ void main() async {
 
 runApp(
   WidgetsBindingObserverWidget(
-    child: ChangeNotifierProvider<ThemeController>.value(
-      value: themeController,
-      child: const MyApp(),
+    child: ProviderScope(
+      overrides: [
+        themeControllerProvider.overrideWith((ref) => themeController),
+      ],
+      child: ChangeNotifierProvider<ThemeController>.value(
+        value: themeController,
+        child: const MyApp(),
+      ),
     ),
   ),
 );
 
 }
-class MyApp extends StatelessWidget {
+class MyApp extends ConsumerWidget {
   const MyApp({super.key});
 
   @override
-  Widget build(BuildContext context) {
-    final themeController = context.watch<ThemeController>();
+  Widget build(BuildContext context, WidgetRef ref) {
+    final themeController = ref.watch(themeControllerProvider);
     return MaterialApp(
       title: 'Ell-ena',
       debugShowCheckedModeBanner: false,

lib/providers/dashboard/dashboard_controller.dart

@@ -0,0 +1,38 @@
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+import 'models/dashboard_state.dart';
+import 'models/enums/dashboard_list_filter.dart';
+
+part 'dashboard_controller.g.dart';
+
+/// Single controller for dashboard-related Riverpod state.
+@Riverpod(keepAlive: true)
+class DashboardController extends _$DashboardController {
+  @override
+  DashboardState build() => const DashboardState();
+
+  /// Sets chart range: 0 = week, 1 = month.
+  void setTimeRange(int timeRange) {
+    state = state.copyWith(timeRange: timeRange);
+  }
+
+  /// Sets the active workspace/team id.
+  void setSelectedTeam(String? teamId) {
+    state = state.copyWith(selectedTeamId: teamId);
+  }
+
+  /// Clears the selected team.
+  void clearSelectedTeam() {
+    setSelectedTeam(null);
+  }
+
+  /// Sets the dashboard list filter.
+  void setFilter(DashboardListFilter filter) {
+    state = state.copyWith(listFilter: filter);
+  }
+
+  /// Resets dashboard state to defaults.
+  void reset() {
+    state = const DashboardState();
+  }
+}

lib/providers/dashboard/dashboard_controller.g.dart

@@ -0,0 +1,19 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+import 'enums/dashboard_list_filter.dart';
+
+part 'dashboard_state.freezed.dart';
+
+/// Dashboard UI state managed by [DashboardController].
+///
+/// Chart range uses the same values as [DashboardScreen]: 0 = week, 1 = month.
+/// Team display name is derived from profile/teams data — only [selectedTeamId]
+/// is stored here.
+@freezed
+class DashboardState with _$DashboardState {
+  const factory DashboardState({
+    @Default(0) int timeRange,
+    String? selectedTeamId,
+    @Default(DashboardListFilter.all) DashboardListFilter listFilter,
+  }) = _DashboardState;
+}