1# Project Structure
2 
3## Feature-Based Structure
4 
5```
6lib/
7├── main.dart
8├── app.dart
9├── core/
10│   ├── constants/
11│   │   ├── colors.dart
12│   │   └── strings.dart
13│   ├── theme/
14│   │   ├── app_theme.dart
15│   │   └── text_styles.dart
16│   ├── utils/
17│   │   ├── extensions.dart
18│   │   └── validators.dart
19│   └── errors/
20│       └── failures.dart
21├── features/
22│   ├── auth/
23│   │   ├── data/
24│   │   │   ├── repositories/
25│   │   │   └── datasources/
26│   │   ├── domain/
27│   │   │   ├── entities/
28│   │   │   └── usecases/
29│   │   ├── presentation/
30│   │   │   ├── screens/
31│   │   │   └── widgets/
32│   │   └── providers/
33│   │       └── auth_provider.dart
34│   └── home/
35│       ├── data/
36│       ├── domain/
37│       ├── presentation/
38│       └── providers/
39├── shared/
40│   ├── widgets/
41│   │   ├── buttons/
42│   │   ├── inputs/
43│   │   └── cards/
44│   ├── services/
45│   │   ├── api_service.dart
46│   │   └── storage_service.dart
47│   └── models/
48│       └── user.dart
49└── routes/
50    └── app_router.dart
51```
52 
53## pubspec.yaml Essentials
54 
55```yaml
56dependencies:
57  flutter:
58    sdk: flutter
59  # State Management
60  flutter_riverpod: ^2.5.0
61  riverpod_annotation: ^2.3.0
62  # Navigation
63  go_router: ^14.0.0
64  # Networking
65  dio: ^5.4.0
66  # Code Generation
67  freezed_annotation: ^2.4.0
68  json_annotation: ^4.8.0
69  # Storage
70  shared_preferences: ^2.2.0
71  hive_flutter: ^1.1.0
72 
73dev_dependencies:
74  flutter_test:
75    sdk: flutter
76  build_runner: ^2.4.0
77  riverpod_generator: ^2.4.0
78  freezed: ^2.5.0
79  json_serializable: ^6.8.0
80  flutter_lints: ^4.0.0
81```
82 
83## Feature Layer Responsibilities
84 
85| Layer | Responsibility |
86|-------|----------------|
87| **data/** | API calls, local storage, DTOs |
88| **domain/** | Business logic, entities, use cases |
89| **presentation/** | UI screens, widgets |
90| **providers/** | Riverpod providers for feature |
91 
92## Main Entry Point
93 
94```dart
95// main.dart
96void main() async {
97  WidgetsFlutterBinding.ensureInitialized();
98  await Hive.initFlutter();
99  runApp(const ProviderScope(child: MyApp()));
100}
101 
102// app.dart
103class MyApp extends ConsumerWidget {
104  const MyApp({super.key});
105 
106  @override
107  Widget build(BuildContext context, WidgetRef ref) {
108    final router = ref.watch(routerProvider);
109 
110    return MaterialApp.router(
111      routerConfig: router,
112      theme: AppTheme.light,
113      darkTheme: AppTheme.dark,
114      themeMode: ThemeMode.system,
115    );
116  }
117}
118```
119