Bump version 0.3.12 retain theme across restart

Author: gjwgit

CHANGELOG.md

@@ -15,6 +15,7 @@ au](https://solidcommunity.au/docs/solidui)
 
 ## 0.4.0 Refine and Tune
 
++ Retain app theme across restart [0.3.12 20260409 gjw]
 + Add get key if required to login [0.3.11 20260406 tonypioneer]
 + Fine tune UX for SolidScaffold elements [0.3.10 20260406 gjw]
 + List files/folder count in FileBrowser, not just file count [0.3.9 20260402 gjw]

lib/src/widgets/solid_login.dart

@@ -202,6 +202,9 @@ class _SolidLoginState extends State<SolidLogin> with WidgetsBindingObserver {
     WidgetsBinding.instance.addObserver(this);
     solidThemeNotifier.addListener(_onThemeChanged);
 
+    // Load the persisted theme preference before the first build.
+    _initTheme();
+
     // Initialise focus nodes for keyboard navigation.
 
     _loginFocusNode = FocusNode(debugLabel: 'loginButton');
@@ -297,6 +300,11 @@ class _SolidLoginState extends State<SolidLogin> with WidgetsBindingObserver {
   void _onThemeChanged() => mounted ? setState(() {}) : null;
   bool get isDarkMode => SolidLoginThemeHelper.isDarkMode(context);
 
+  Future<void> _initTheme() async {
+    await solidThemeNotifier.initialize();
+    if (mounted) setState(() {});
+  }
+
   Future<void> _initPackageInfo() async {
     if (!mounted) return;
     await setAppDirName(widget.appDirectory);

lib/src/widgets/solid_theme_notifier.dart

@@ -24,17 +24,25 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 ///
-/// Authors: Tony Chen
+/// Authors: Tony Chen, Graham Williams
 
 library;
 
 import 'package:flutter/material.dart';
 import 'package:flutter/scheduler.dart';
 
+import 'package:shared_preferences/shared_preferences.dart';
+
 import 'package:solidui/src/widgets/solid_preferences_models.dart';
 
+/// SharedPreferences key for persisting the theme mode across app restarts.
+
+const _kThemeModeKey = 'solidui_theme_mode';
+
 /// Notifier for managing theme state across the application.
-/// The theme always starts in System mode.
+///
+/// Theme is persisted across app restarts using SharedPreferences. On first
+/// launch (no saved preference) the theme defaults to System mode.
 
 class SolidThemeNotifier extends ChangeNotifier {
   ThemeMode _themeMode = ThemeMode.system;
@@ -52,36 +60,54 @@ class SolidThemeNotifier extends ChangeNotifier {
 
   bool get isInitialized => _isInitialized;
 
-  /// Initialises the notifier.
-  /// Theme always starts in System mode.
+  /// Initialises the notifier by loading the persisted theme preference.
+  ///
+  /// Must be awaited before the first build so that the correct theme is
+  /// applied without a flash:
+  ///
+  /// ```dart
+  /// Future<void> _initTheme() async {
+  ///   await _themeNotifier.initialize();
+  ///   if (mounted) setState(() {});
+  /// }
+  /// ```
 
   Future<void> initialize() async {
     if (_isInitialized) return;
 
-    _themeMode = ThemeMode.system;
+    // Load previously saved theme mode from SharedPreferences.
+    final prefs = await SharedPreferences.getInstance();
+    final saved = prefs.getString(_kThemeModeKey);
+    _themeMode = _themeModeFromString(saved);
     _isInitialized = true;
     notifyListeners();
   }
 
-  /// Sets a specific theme mode.
+  /// Sets a specific theme mode and persists it to SharedPreferences.
 
   void setThemeMode(ThemeMode themeMode) {
     if (_themeMode == themeMode) return;
 
     _themeMode = themeMode;
     notifyListeners();
+
+    // Persist asynchronously — fire and forget is safe here since
+    // SharedPreferences writes are fast and non-critical.
+    SharedPreferences.getInstance().then(
+      (prefs) => prefs.setString(_kThemeModeKey, _themeModeToString(themeMode)),
+    );
   }
 
-  /// Toggles between System mode and the opposite of current system mode.
+  /// Toggles between System mode and the opposite of the current system mode.
   ///
-  /// When in System mode, switches to the opposite of current system
-  /// mode. When in Light or Dark mode, switches back to System mode.
+  /// When in System mode, switches to the opposite of the current system
+  /// brightness. When in Light or Dark mode, switches back to System mode.
+  /// The selected mode is persisted via [setThemeMode].
 
   void toggleTheme() {
     switch (_themeMode) {
       case ThemeMode.system:
         // Detect current system brightness and switch to the opposite mode.
-
         final systemBrightness =
             SchedulerBinding.instance.platformDispatcher.platformBrightness;
         if (systemBrightness == Brightness.light) {
@@ -94,7 +120,6 @@ class SolidThemeNotifier extends ChangeNotifier {
       case ThemeMode.light:
       case ThemeMode.dark:
         // Switch back to System mode.
-
         setThemeMode(ThemeMode.system);
         break;
     }
@@ -127,6 +152,20 @@ class SolidThemeNotifier extends ChangeNotifier {
   ''';
     }
   }
+
+  // ── Serialisation helpers ─────────────────────────────────────────────────
+
+  static String _themeModeToString(ThemeMode mode) => switch (mode) {
+        ThemeMode.light => 'light',
+        ThemeMode.dark => 'dark',
+        ThemeMode.system => 'system',
+      };
+
+  static ThemeMode _themeModeFromString(String? value) => switch (value) {
+        'light' => ThemeMode.light,
+        'dark' => ThemeMode.dark,
+        _ => ThemeMode.system, // default for null or unrecognised values
+      };
 }
 
 /// Global instance of the theme notifier.

pubspec.yaml

@@ -1,6 +1,6 @@
 name: solidui
 description: 'A UI library for building Solid applications with Flutter.'
-version: 0.3.11
+version: 0.3.12
 homepage: https://github.com/anusii/solidui
 
 environment: