diff --git a/docs/workspace/imgs/dark-mode-toggle.avif b/docs/workspace/imgs/dark-mode-toggle.avif new file mode 100644 index 0000000..7bc79f7 Binary files /dev/null and b/docs/workspace/imgs/dark-mode-toggle.avif differ diff --git a/docs/workspace/imgs/theme-panel.avif b/docs/workspace/imgs/theme-panel.avif index 83fbef0..f051d9f 100644 Binary files a/docs/workspace/imgs/theme-panel.avif and b/docs/workspace/imgs/theme-panel.avif differ diff --git a/docs/workspace/imgs/typography-section.avif b/docs/workspace/imgs/typography-section.avif new file mode 100644 index 0000000..670c01d Binary files /dev/null and b/docs/workspace/imgs/typography-section.avif differ diff --git a/docs/workspace/modules-panel/theme.md b/docs/workspace/modules-panel/theme.md index a20acf5..9834e15 100644 --- a/docs/workspace/modules-panel/theme.md +++ b/docs/workspace/modules-panel/theme.md @@ -9,70 +9,25 @@ keywords: [dreamflow theme, app theme, dark mode, light mode, colors, typography # Theme -The **Theme** panel in Dreamflow provides a centralized way to manage the visual identity of your app. Instead of hardcoding styles in multiple places, you can define colors, typography, and style values once and reuse them consistently across your project. This ensures your app maintains a polished, cohesive look while making design updates faster and easier. +The **Theme** panel in Dreamflow provides a centralized way to manage the visual identity of your app. Instead of hardcoding styles in multiple places, you can define colors, typography, style, and size values once and reuse them consistently across your project. This ensures your app maintains a polished, cohesive look while making design updates faster and easier. You can navigate to the Theme panel by clicking the theme button in the left side rail. Values defined in your Theme panel are accessible within the property editor. For example, theme colors are accessible in the color picker when setting a color property. ![theme-panel](../imgs/theme-panel.avif) -## Colors - -In Dreamflow, colors are grouped into three categories: - -- **Brand Colors**: Represent your brand’s primary palette (e.g., primary, secondary, accent). Use these to give your app its unique identity. -- **Utility Colors**: These are functional colors that support layout and contrast. -- **Semantic Colors**: Contextual colors that represent meaning within the app for states like errors or warnings. - - :::info -Each brand color includes a **hex value** (e.g., `#7C4DFF`) and an **opacity setting** so you can fine-tune how they appear in your design. You can edit the values for each of these in the Theme Panel and see the values updated in realtime in the preview. - -::: - -### Dark Mode +The Theme module is **powered by AI** and works directly with your existing theme code. It doesn’t require a specific structure or strict patterns. Whether you’re using standard Material themes, custom theme classes, or your own organization style, the Theme panel understands it and provides type-aware editors for colors, typography, and style values. -Dreamflow makes it easy to design and preview your app in both **Light Mode** and **Dark Mode**. In the Theme panel, you can select **Dark Mode** from the dropdown. Set your colors for dark mode, then switch the mode in the Preview canvas to instantly see your design in action. +When you update your theme files, the Theme module automatically refreshes to reflect those changes, so everything stays in sync. -:::info -When you switch modes, Dreamflow automatically applies the corresponding color palettes, allowing you to check readability, contrast, and overall aesthetics in real time. ::: -
- -
-

- -### Best Practices +### Dark Mode -To get the most out of Dreamflow’s color system, keep these guidelines in mind: +Dreamflow makes it easy to design and preview your app in both Light Mode and Dark Mode. In the Theme panel, you can select Dark Mode from the toggle icon. When you switch modes, Dreamflow automatically applies the corresponding color palettes, allowing you to check readability, contrast, and overall aesthetics in real time. -- **Maintain contrast**: Always ensure sufficient contrast between foreground (text/icons) and background colors for accessibility. -- **Be consistent**: Use brand colors consistently for key elements such as buttons and text so users quickly learn their meaning. -- **Leverage semantic colors**: Don’t reinvent error, warning, or success colors; stick to semantic definitions for clarity. -- **Test both modes**: Always check your design in **Light Mode** and **Dark Mode** to ensure readability and visual harmony. -- **Avoid color overload**: Use a limited palette so your app feels cohesive rather than chaotic. +![dark-mode-toggle](../imgs/dark-mode-toggle.avif) ## Typography @@ -84,13 +39,24 @@ Typography in Dreamflow ensures that text styles remain consistent throughout yo - **Body**: Paragraphs, descriptions, and content-heavy areas. - **Label**: Smaller text for buttons, captions, or UI labels. -You can modify your text styles in the Theme panel and then use them anywhere a `TextSyle` class is expected - for example, in the style property of the `Text` widget. Use the "Apply Theme" button next to the `Style` property in the property panel to select your text style. +You can modify your text styles in the **Theme > Typography** section and then use them anywhere a `TextSyle` class is expected - for example, in the Text Style property of the Text widget. + +![typography](../imgs/typography-section.avif) + +## Sizing Sections +- **Spacing Values:** Defines the core spacing scale (such as XS, SM, MD, LG) used across the app for padding, margins, gaps, and layout spacing. +- **Edge Insets Shortcuts:** Provides reusable padding and margin presets built from spacing values. +- **Horizontal/Vertical Padding:** Defines standardized padding presets applied symmetrically, commonly used for buttons, cards, inputs, and containers to avoid inconsistent spacing. +- **Border Radius:** Defines reusable corner radius values. +- **Font Sizes:** Defines the numeric font size scale used by text styles. -## Style Constants +## Best Practices -Style constants define reusable design values across your app, helping you maintain consistency in both light and dark modes. +To get the most out of Dreamflow’s color system, keep these guidelines in mind: -- **Light Mode Colors**: Default color set when your app is displayed in light mode. -- **Dark Mode Colors**: Color overrides for dark mode. -- **Font Sizes**: Centralized definitions for text sizing. \ No newline at end of file +- **Maintain contrast**: Always ensure sufficient contrast between foreground (text/icons) and background colors for accessibility. +- **Be consistent**: Use brand colors consistently for key elements such as buttons and text so users quickly learn their meaning. +- **Leverage semantic colors**: Don’t reinvent error, warning, or success colors; stick to semantic definitions for clarity. +- **Test both modes**: Always check your design in **Light Mode** and **Dark Mode** to ensure readability and visual harmony. +- **Avoid color overload**: Use a limited palette so your app feels cohesive rather than chaotic.