Epic: Catppuccin Mocha Icon System Migration #7

New Issue

forbes · 2026-02-05T16:27:14Z

forbes commented

2026-02-05 16:27:14 +00:00

Overview

Migrate Kindred Create from FreeCAD's default icons to a custom, simplified Catppuccin Mocha themed icon set. This provides visual consistency with our theme and establishes a unique identity for Kindred Create.

Goals

Visual Consistency: All icons use the Catppuccin Mocha color palette
Simplicity: Clean, minimal SVG icons that are easy to understand
Flexibility: Support for future theme switching and customization
Maintainability: Consistent design system makes creating new icons straightforward

Design System

Icon Template

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
  <rect x="2" y="2" width="28" height="28" rx="4" fill="#313244"/>
  <!-- Icon content -->
</svg>

Catppuccin Mocha Palette

Color	Hex	Usage
Base	`#1e1e2e`	Backgrounds
Surface0	`#313244`	Icon backgrounds
Surface1	`#45475a`	Hover states
Text	`#cdd6f4`	Primary elements
Blue	`#89b4fa`	File operations
Green	`#a6e3a1`	Creation/Success
Red	`#f38ba8`	Deletion/Error
Yellow	`#f9e2af`	Sketcher
Mauve	`#cba6f7`	Accents
Peach	`#fab387`	Warnings/Settings

Workbench Color Coding

Each workbench uses a distinct accent color for its icons to help users quickly identify context.

Implementation Phases

#3 Infrastructure: Set up icon override system
#4 Phase 1: Core toolbar icons (~25 icons)
#5 Phase 2: Workbench icons (~50 icons)
#6 Phase 3: Complete icon set + theme switching (~200+ icons)

Existing Work

The ztools addon already contains 36 Catppuccin Mocha themed icons that serve as the reference implementation. See mods/ztools/ztools/ztools/resources/icons.py.

Success Metrics

All visible toolbar icons use Catppuccin theme
No visual inconsistency between themed and unthemed icons
Icons render crisp at all common sizes (16, 24, 32, 64px)
Theme can be extended or modified by users

## Overview Migrate Kindred Create from FreeCAD's default icons to a custom, simplified Catppuccin Mocha themed icon set. This provides visual consistency with our theme and establishes a unique identity for Kindred Create. ## Goals 1. **Visual Consistency**: All icons use the Catppuccin Mocha color palette 2. **Simplicity**: Clean, minimal SVG icons that are easy to understand 3. **Flexibility**: Support for future theme switching and customization 4. **Maintainability**: Consistent design system makes creating new icons straightforward ## Design System ### Icon Template ```svg <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"> <rect x="2" y="2" width="28" height="28" rx="4" fill="#313244"/>  </svg> ``` ### Catppuccin Mocha Palette | Color | Hex | Usage | |-------|-----|-------| | Base | `#1e1e2e` | Backgrounds | | Surface0 | `#313244` | Icon backgrounds | | Surface1 | `#45475a` | Hover states | | Text | `#cdd6f4` | Primary elements | | Blue | `#89b4fa` | File operations | | Green | `#a6e3a1` | Creation/Success | | Red | `#f38ba8` | Deletion/Error | | Yellow | `#f9e2af` | Sketcher | | Mauve | `#cba6f7` | Accents | | Peach | `#fab387` | Warnings/Settings | ### Workbench Color Coding Each workbench uses a distinct accent color for its icons to help users quickly identify context. ## Implementation Phases - [ ] #3 **Infrastructure**: Set up icon override system - [ ] #4 **Phase 1**: Core toolbar icons (~25 icons) - [ ] #5 **Phase 2**: Workbench icons (~50 icons) - [ ] #6 **Phase 3**: Complete icon set + theme switching (~200+ icons) ## Existing Work The `ztools` addon already contains 36 Catppuccin Mocha themed icons that serve as the reference implementation. See `mods/ztools/ztools/ztools/resources/icons.py`. ## Success Metrics - All visible toolbar icons use Catppuccin theme - No visual inconsistency between themed and unthemed icons - Icons render crisp at all common sizes (16, 24, 32, 64px) - Theme can be extended or modified by users

forbes closed this issue

2026-02-05 22:50:52 +00:00

forbes commented

2026-02-05 22:51:07 +00:00

All phases complete. Closing with code references:

191 SVG icons in kindred-icons/ using Catppuccin Mocha palette
Icon override infrastructure: src/Gui/BitmapFactory.cpp:70 — kindred-icons path added with highest priority
Theme/stylesheet: src/Gui/PreferencePacks/KindredCreate/ and src/Gui/Stylesheets/KindredCreate.qss
Icon README: kindred-icons/README.md documents design system and palette
Sub-issues #3, #4, #5, #6 all closed

All phases complete. Closing with code references: - **191 SVG icons** in `kindred-icons/` using Catppuccin Mocha palette - **Icon override infrastructure**: `src/Gui/BitmapFactory.cpp:70` — kindred-icons path added with highest priority - **Theme/stylesheet**: `src/Gui/PreferencePacks/KindredCreate/` and `src/Gui/Stylesheets/KindredCreate.qss` - **Icon README**: `kindred-icons/README.md` documents design system and palette - Sub-issues #3, #4, #5, #6 all closed

forbes referenced this issue

2026-02-08 23:25:54 +00:00

bug(silo): Silo_BOM requires Silo-tracked document with no registration path #56

forbes referenced this issue

2026-02-12 20:48:21 +00:00

feat: add placeholder SVGs for all missing FreeCAD icons #183

forbes referenced this issue from a commit

2026-02-14 16:31:26 +00:00

OpenSCAD module

forbes referenced this issue from a commit

2026-02-14 16:31:29 +00:00

Merge pull request #7 from luzpaz/path-source-typo