Start to build app skeleton

moneymgr_mobile/lib/main.dart

@@ -1,122 +1,93 @@
 import 'package:flutter/material.dart';
+import 'package:flutter_hooks/flutter_hooks.dart';
+import 'package:flutter_native_splash/flutter_native_splash.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:moneymgr_mobile/providers/settings.dart';
+import 'package:moneymgr_mobile/services/storage/prefs.dart';
+import 'package:moneymgr_mobile/utils/provider_observer.dart';
+import 'package:moneymgr_mobile/utils/theme_utils.dart';
 
-void main() {
-  runApp(const MyApp());
+// Inspired from https://github.com/dhafinrayhan/dummymart
+
+Future<void> main() async {
+  WidgetsBinding widgetsBinding = WidgetsFlutterBinding.ensureInitialized();
+
+  // We preserve the native splash screen, which will then removed once the main
+  // app is inserted to the widget tree.
+  FlutterNativeSplash.preserve(widgetsBinding: widgetsBinding);
+
+  runApp(ProviderScope(
+    observers: [AppProviderObserver()],
+    child: const MoneyMgrApp(),
+  ));
 }
 
-class MyApp extends StatelessWidget {
-  const MyApp({super.key});
+class MoneyMgrApp extends StatelessWidget {
+  const MoneyMgrApp({super.key});
 
-  // This widget is the root of your application.
   @override
   Widget build(BuildContext context) {
-    return MaterialApp(
-      title: 'Flutter Demo',
-      theme: ThemeData(
-        // This is the theme of your application.
-        //
-        // TRY THIS: Try running your application with "flutter run". You'll see
-        // the application has a purple toolbar. Then, without quitting the app,
-        // try changing the seedColor in the colorScheme below to Colors.green
-        // and then invoke "hot reload" (save your changes or press the "hot
-        // reload" button in a Flutter-supported IDE, or press "r" if you used
-        // the command line to start the app).
-        //
-        // Notice that the counter didn't reset back to zero; the application
-        // state is not lost during the reload. To reset the state, use hot
-        // restart instead.
-        //
-        // This works for code too, not just values: Most code changes can be
-        // tested with just a hot reload.
-        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
-      ),
-      home: const MyHomePage(title: 'Flutter Demo Home Page'),
+    return const _EagerInitialization(
+      child: _MainApp(),
     );
   }
 }
 
-class MyHomePage extends StatefulWidget {
-  const MyHomePage({super.key, required this.title});
-
-  // This widget is the home page of your application. It is stateful, meaning
-  // that it has a State object (defined below) that contains fields that affect
-  // how it looks.
-
-  // This class is the configuration for the state. It holds the values (in this
-  // case the title) provided by the parent (in this case the App widget) and
-  // used by the build method of the State. Fields in a Widget subclass are
-  // always marked "final".
-
-  final String title;
+class _EagerInitialization extends ConsumerWidget {
+  const _EagerInitialization({required this.child});
+  final Widget child;
 
   @override
-  State<MyHomePage> createState() => _MyHomePageState();
+  Widget build(BuildContext context, WidgetRef ref) {
+    final values = [
+      ref.watch(prefsProvider),
+    ];
+
+    if (values.every((value) => value.hasValue)) {
+      return child;
+    }
+
+    return const SizedBox();
+  }
 }
 
-class _MyHomePageState extends State<MyHomePage> {
-  int _counter = 0;
+class _MainApp extends StatefulHookConsumerWidget {
+  const _MainApp();
 
-  void _incrementCounter() {
-    setState(() {
-      // This call to setState tells the Flutter framework that something has
-      // changed in this State, which causes it to rerun the build method below
-      // so that the display can reflect the updated values. If we changed
-      // _counter without calling setState(), then the build method would not be
-      // called again, and so nothing would appear to happen.
-      _counter++;
-    });
+  @override
+  ConsumerState<_MainApp> createState() => _MainAppState();
+}
+
+
+class _MainAppState extends ConsumerState<_MainApp> {
+  @override
+  void initState() {
+    super.initState();
+    FlutterNativeSplash.remove();
   }
 
   @override
   Widget build(BuildContext context) {
-    // This method is rerun every time setState is called, for instance as done
-    // by the _incrementCounter method above.
-    //
-    // The Flutter framework has been optimized to make rerunning build methods
-    // fast, so that you can just rebuild anything that needs updating rather
-    // than having to individually change instances of widgets.
-    return Scaffold(
-      appBar: AppBar(
-        // TRY THIS: Try changing the color here to a specific color (to
-        // Colors.amber, perhaps?) and trigger a hot reload to see the AppBar
-        // change color while the other colors stay the same.
-        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
-        // Here we take the value from the MyHomePage object that was created by
-        // the App.build method, and use it to set our appbar title.
-        title: Text(widget.title),
-      ),
-      body: Center(
-        // Center is a layout widget. It takes a single child and positions it
-        // in the middle of the parent.
-        child: Column(
-          // Column is also a layout widget. It takes a list of children and
-          // arranges them vertically. By default, it sizes itself to fit its
-          // children horizontally, and tries to be as tall as its parent.
-          //
-          // Column has various properties to control how it sizes itself and
-          // how it positions its children. Here we use mainAxisAlignment to
-          // center the children vertically; the main axis here is the vertical
-          // axis because Columns are vertical (the cross axis would be
-          // horizontal).
-          //
-          // TRY THIS: Invoke "debug painting" (choose the "Toggle Debug Paint"
-          // action in the IDE, or press "p" in the console), to see the
-          // wireframe for each widget.
-          mainAxisAlignment: MainAxisAlignment.center,
-          children: <Widget>[
-            const Text('You have pushed the button this many times:'),
-            Text(
-              '$_counter',
-              style: Theme.of(context).textTheme.headlineMedium,
-            ),
-          ],
+    final router = ref.watch(routerProvider);
+    final themeMode = ref.watch(currentThemeModeProvider);
+
+    final (lightTheme, darkTheme) = useMemoized(() => createDualThemeData(
+      seedColor: Colors.blue,
+      useMaterial3: true,
+      transformer: (data) => data.copyWith(
+        inputDecorationTheme: const InputDecorationTheme(
+          border: OutlineInputBorder(),
         ),
       ),
-      floatingActionButton: FloatingActionButton(
-        onPressed: _incrementCounter,
-        tooltip: 'Increment',
-        child: const Icon(Icons.add),
-      ), // This trailing comma makes auto-formatting nicer for build methods.
+    ));
+
+    return MaterialApp.router(
+      title: 'MoneyMgr',
+      themeMode: themeMode,
+      theme: lightTheme,
+      darkTheme: darkTheme,
+      routerConfig: router,
+      debugShowCheckedModeBanner: false,
     );
   }
-}
+}

moneymgr_mobile/lib/providers/settings.dart

@@ -0,0 +1,37 @@
+import 'package:flutter/material.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+import '../../../services/storage/prefs.dart';
+
+part 'settings.g.dart';
+
+/// The current theme mode of the app.
+///
+/// When this provider is first read, it will read the saved value from storage,
+/// and defaults to [ThemeMode.system] if the theme mode has not been set before.
+@riverpod
+class CurrentThemeMode extends _$CurrentThemeMode {
+  @override
+  ThemeMode build() {
+    final prefs = ref.watch(prefsProvider).requireValue;
+
+    // Load the saved theme mode setting from shared preferences.
+    final themeModeName = prefs.getString('themeMode');
+
+    // Return [ThemeMode] based on the saved setting, or [ThemeMode.system]
+    // if there's no saved setting yet.
+    return ThemeMode.values.singleWhere(
+          (themeMode) => themeMode.name == themeModeName,
+      orElse: () => ThemeMode.system,
+    );
+  }
+
+  void set(ThemeMode themeMode) {
+    final prefs = ref.read(prefsProvider).requireValue;
+
+    // Save the new theme mode to shared preferences.
+    prefs.setString('themeMode', themeMode.name);
+
+    ref.invalidateSelf();
+  }
+}

moneymgr_mobile/lib/services/storage/prefs.dart

@@ -0,0 +1,11 @@
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+part 'prefs.g.dart';
+
+@riverpod
+Future<SharedPreferencesWithCache> prefs(Ref ref) =>
+    SharedPreferencesWithCache.create(
+      cacheOptions: const SharedPreferencesWithCacheOptions(),
+    );

moneymgr_mobile/lib/utils/provider_observer.dart

@@ -0,0 +1,42 @@
+import 'package:flutter/foundation.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+
+/// A utility to observe Riverpod providers.
+class AppProviderObserver extends ProviderObserver {
+  @override
+  void didAddProvider(
+    ProviderBase<Object?> provider,
+    Object? value,
+    ProviderContainer container,
+  ) {
+    debugPrint('Provider $provider was initialized with $value');
+  }
+
+  @override
+  void didDisposeProvider(
+    ProviderBase<Object?> provider,
+    ProviderContainer container,
+  ) {
+    debugPrint('Provider $provider was disposed');
+  }
+
+  @override
+  void didUpdateProvider(
+    ProviderBase<Object?> provider,
+    Object? previousValue,
+    Object? newValue,
+    ProviderContainer container,
+  ) {
+    debugPrint('Provider $provider updated from $previousValue to $newValue');
+  }
+
+  @override
+  void providerDidFail(
+    ProviderBase<Object?> provider,
+    Object error,
+    StackTrace stackTrace,
+    ProviderContainer container,
+  ) {
+    debugPrint('Provider $provider threw $error at $stackTrace');
+  }
+}

moneymgr_mobile/lib/utils/theme_utils.dart

@@ -0,0 +1,36 @@
+import 'package:flutter/material.dart';
+
+/// Creates two [ThemeData]s (light and dark variants) from a given [seedColor].
+///
+/// This method is needed because once a [ThemeData] is generated, we cannot get
+/// the [ColorScheme] seed to generate another one based on the same seed.
+(ThemeData, ThemeData) createDualThemeData({
+  required Color seedColor,
+  TextTheme? textTheme,
+  bool? useMaterial3,
+  ThemeData Function(ThemeData)? transformer,
+}) {
+  var lightTheme = ThemeData.from(
+    colorScheme: ColorScheme.fromSeed(
+      seedColor: seedColor,
+      brightness: Brightness.light,
+    ),
+    textTheme: textTheme,
+    useMaterial3: useMaterial3,
+  );
+  var darkTheme = ThemeData.from(
+    colorScheme: ColorScheme.fromSeed(
+      seedColor: seedColor,
+      brightness: Brightness.dark,
+    ),
+    textTheme: textTheme,
+    useMaterial3: useMaterial3,
+  );
+
+  if (transformer != null) {
+    lightTheme = transformer(lightTheme);
+    darkTheme = transformer(darkTheme);
+  }
+
+  return (lightTheme, darkTheme);
+}