theme_setting

A lightweight and customizable Flutter package for managing app themes and dark mode, featuring persistent state management using hydrated_bloc. It provides a dark mode toggle widget, theme enum support, JSON color utilities, and a builder widget for applying theme-aware UI.

---

✨ Features

• Toggle dark mode with state persistence
• Hydrated BLoC integration
• Singleton-based color conversion utility
• get_it integration for dependency injection
• Easy-to-use widget for theme switching
• Builder widget (AppThemeBuilder) to apply theme-aware UI

---

🚀 Getting Started

Installation

Add this to your pubspec.yaml:

dependencies:
  theme_setting: <latest_version>

---

🔧 Usage

1. Register the Theme Cubit

import 'package:global/get_it_di.dart';
import 'package:theme_setting/theme_setting.dart';

void themeSettingGetItRegister() {
  sl.registerLazySingleton(() => DarkModeHydratedCubit());
}

2. Use the Theme Switch Widget

import 'package:theme_setting/theme_setting.dart';

class SettingsPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: ThemeSwitchDarkModeHydratedCubitImpl(),
    );
  }
}

3. Apply Theme Based on Cubit State (Manual Integration)

BlocBuilder<DarkModeHydratedCubit, bool>(
  builder: (context, isDark) {
    return MaterialApp(
      theme: isDark ? ThemeData.dark() : ThemeData.light(),
      home: MyHomePage(),
    );
  },
);

4. Use AppThemeBuilder for Theme-Aware Widgets

import 'package:theme_setting/theme_setting.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return AppThemeBuilder(
      child: MaterialApp(
        home: MyHomePage(),
      ),
    );
  }
}

AppThemeBuilder listens to DarkModeHydratedCubit and rebuilds the widget tree when dark mode changes.

---

🔄 Color JSON Utility

final colorJson = JsonColorUtil.convertColorToJson(Colors.blue);
final color = JsonColorUtil.convertJsonToColor(colorJson);

---

📦 Exports

export 'theme_bloc.dart';
export 'theme_event.dart';
export 'theme_state.dart';
export 'package:theme_setting/view_models/dark_mode_hydrated_cubit/dark_mode_hydrated_cubit.dart';
export 'package:theme_setting/widgets/theme_switch_dark_mode_hydrated_cubit_impl.dart';
export 'package:theme_setting/widgets/app_theme_builder.dart';

---

📢 Contributions

Contributions and issues are welcome! Feel free to fork the repository and make pull requests.

---

📚 License

MIT License. See LICENSE for details.