mirror of
https://github.com/Such-Software/hash-wallet.git
synced 2026-10-18 05:51:34 +02:00
df88914628
* Add theme base v2 * Initial new theme base files * Typos * Fixes * Update theme files * feat: Migrate to Material 3 Theming Foundation, Theme Data Refactor, and First Extension Cleanup Batch. This commit completes the first major phase of migrating to Material 3 theming by setting up the foundations for material 3 integration and begins the initial migration, removing custom theme extensions, updating theme data, and refactoring all relevant widget and page theming to use Material 3’s built-in color and typography tokens. These changes: - Lays the groundwork for Material 3 theming by restructuring the app’s theme configuration to use Material 3’s ColorScheme and TextTheme as the primary sources of color and typography throughout the app. - Refactors the core theme config files by removing legacy custom color roles ensuring all color definitions now map directly to Material 3’s role. - Begins the first batch migration of custom theme extensions (InfoTheme, PlaceholderTheme, KeyboardTheme, PinCodeTheme) and updates all affected widgets and pages to use Material 3 color and typography tokens instead of the custom properties. - Cleans up the codebase by deleting the files of the initial set of migrated extensions and eliminating all related imports and usages. * feat: Migrate to Material 3 Theming. This change: - Updates the themes README.md file to reflect the current structure and give more information based on the first major phase that was completed. * feat: Migrate to Material 3 Theming Deleting previous theme extensions * feat: Migrate to Material 3 Theming Another batch of migrations from existing extensions * feat: Migration to Material 3 Theming Third Migration batch for theme extensions * fwat: Migration to Material 3 Theming Final Migration batch for previous theme extensions * Update onboarding hero * Update button radius * Add surfaceContainer to light theme * feat(themes): Migrate to Material 3 Theming This change: - Adds new set of hero images - Modifies the core structure for the themes - Add missing color tokens to the theme classes - Adds a CustomThemeColor class for custom color tokens - Modifies the themelist to have a fall back for previous theme implementation - Adds localization for some texts - Modifies the flow for loading the theme on app start - Add a WidgetsBindingObserver that listens for changes in the device theme and updates the app theme when there is a change - Registers the themeStore as a Singleton for codebase wide use * feat(themes): Migrate to Material 3 theming This change: - Migrates UI flows across the app to the new themes - Confirms styling and typography of components across the app uses the new themes - Remove instances of Palette use - Switch TextStyles across the app to use theme text styles * feat(themes): Migrate to Material 3 Theming. This change: - Adjusts bottomsheets styling and removes duplicate close button - Removes more themedata extensions from the previous implementation * - Remove outlines from cards and dock - Update menu colors - Update padding/divider size for cards * - Update PIN screen - Fix navigation dock shadow - Update wallet screen colors * Update border radius --skip-ci * feat(themes): Migrate to Material 3 Theming. This change: - Adds gradient backgrounds to the dashbaord and balance cards. - Migrates the input fields across the app to BaseTextFormFields. - Removes dependence of input fields on individual styling, focusing instead on using theme defined InputDecoration styling with adjustments on individual components where needed. - Applies new theme styling to BaseTextFormField, AddressTextField and CurrencyAmountTextField. * - Switch some hero images to PNG - Fix nagivation_dock shadow - Minor fixes * feat: Add fallback to previous underline styling in central widgets This change: - Adds a fallback to CurrencyAmountTextField, AddressTextField, and BaseTextFormField, allowing them use the previous theme styling. - Adds localization for new texts * feat(themes): Update warning box colors for dark and light themes * feat(themes): Relaod themes when user restores from backup, ensuring the user previous theme preference is used. * feat(themes): Handle themes logic during restore from backup This change: - Refactors theme loading logic to handle backup restore edgecase - Refreshes the theme based on the user saved preference during restore from backup flow * Fix card gradients and spacing * Fix even more radiuses Test new icons for navigation_dock.dart * Update onboarding flow backgrounds Fix swap icon clipping Fix some text colors Add more hero images * Fix incorrect color for light theme * Fix more hero images and cleanup * Update text field icons Fix info box CTA colors Fix sync indicator colors * Update toggle colors Update dark theme colors (minor) Update crypto_balance_widget.dart icon * Update page transitions in router.dart Fix some colors * feat(themes): Display label by default for filled textfields * feat(themes): Refactor theme handling across various components This change: - Fixes issue with themeMode resetting to system mode when app is restarted causing a UI glitch - Updates theme checks from `currentTheme.type == ThemeType.dark` to `currentTheme.isDark` for consistency - Adjusts UI components to use the theme directly from the themeStore * feat(themes): Add animating tagline to the create pin welcome screen * Revert text fields label temporarily, fix a couple colors, and cleanup some images --------- Co-authored-by: OmarHatem <omarh.ismail1@gmail.com> Co-authored-by: Blazebrain <davidadegoke16@gmail.com>
82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
# Material 3 Theming System
|
|
|
|
This directory contains the Material 3 (M3) theming implementation for Cake Wallet. The theming system is now fully based on Material 3 color tokens and patterns, with all custom theme extensions removed for simplicity, maintainability, and compliance with Material Design 3 guidelines.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
lib/themes/
|
|
├── core/ # Theme state management and base theme logic
|
|
├── theme_classes/ # Light and dark theme data definitions
|
|
├── extensions/ # (Optional) Theme extensions for specific widgets/pages
|
|
├── utils/ # Utilities for theme management
|
|
└── README.md # This file
|
|
```
|
|
|
|
## Key Features
|
|
|
|
- Material 3 color system with semantic color tokens
|
|
- Dynamic color support (when available)
|
|
- MobX-based state management
|
|
- Simplified theme management
|
|
- Consistent design language across the app
|
|
|
|
## Usage
|
|
|
|
### Accessing Theme Colors
|
|
|
|
```dart
|
|
final colorScheme = Theme.of(context).colorScheme;
|
|
final primaryColor = colorScheme.primary;
|
|
final onSurfaceVariant = colorScheme.onSurfaceVariant;
|
|
```
|
|
|
|
### Available Color Tokens
|
|
|
|
Material 3 provides a comprehensive set of semantic color tokens that adapt to light/dark themes:
|
|
|
|
- `primary` / `onPrimary`
|
|
- `secondary` / `onSecondary`
|
|
- `tertiary` / `onTertiary`
|
|
- `error` / `onError`
|
|
- `background` / `onBackground`
|
|
- `surface` / `onSurface`
|
|
- `surfaceVariant` / `onSurfaceVariant`
|
|
- `outline`, `outlineVariant`
|
|
- ...and more (see Flutter's ColorScheme)
|
|
|
|
### Theme Management
|
|
|
|
Theme mode state (light/dark/system) and switching is handled via MobX stores in `core/`. Use the provided store to get/set the current theme mode and listen for changes.
|
|
|
|
```dart
|
|
// Example: Getting the current theme mode
|
|
final themeStore = ... // Obtain from provider or context
|
|
final isDark = themeStore.isDark;
|
|
|
|
// Example: Switching theme mode
|
|
await themeStore.setThemeMode(ThemeMode.dark);
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
1. **Always use semantic color tokens** from `ColorScheme` instead of hardcoded colors.
|
|
2. **Leverage Material 3 components** wherever possible for consistency and accessibility.
|
|
3. **Use the MobX theme store** for all theme-related state and switching.
|
|
4. **Test in both light and dark modes** to ensure good contrast and appearance.
|
|
5. **Keep any theme extensions minimal and focused** (if used at all).
|
|
6. **Do not reintroduce custom theme extensions** unless absolutely necessary and not covered by Material 3.
|
|
|
|
## Adding or Modifying Themes
|
|
|
|
- To update theme colors, edit the files in `theme_classes/` (e.g., `light_theme.dart`, `dark_theme.dart`).
|
|
- To add a new theme variant, create a new file in `theme_classes/` and update the MobX store in `core/` to support it.
|
|
- For widget-specific theming, prefer using Material 3's built-in tokens. Only use a theme extension if there is no Material 3 equivalent.
|
|
|
|
## Contributing
|
|
|
|
- Follow Material 3 color system and accessibility guidelines.
|
|
- Ensure proper contrast ratios for accessibility.
|
|
- Test all changes in both light and dark modes.
|
|
- Update this documentation if you add new color tokens or theme variants.
|
|
- Keep theme files organized and focused. |