Icon Migration: Set up icon override infrastructure #3

Closed
opened 2026-02-05 16:26:10 +00:00 by forbes · 0 comments
Owner

Overview

Set up the infrastructure to support custom Catppuccin Mocha themed icons that override the default FreeCAD icons.

Goals

  1. Create a kindred-icons/ directory structure for custom icons
  2. Configure FreeCAD's icon search path to prioritize custom icons
  3. Establish the icon naming convention that matches FreeCAD's expectations
  4. Document the override mechanism for future icon additions

Technical Approach

  • Use FreeCAD's BitmapFactory search path system
  • Add custom icon path via User parameter:BaseApp/Preferences/Bitmaps
  • Icons in kindred-icons/ will be loaded before compiled resources

Icon Design Standards

All Kindred Create icons must follow these guidelines:

  • ViewBox: 32x32
  • Background: Rounded rectangle (rx=4) with surface0 color (#313244)
  • Stroke width: 1.5-2.5 for main elements
  • Colors: Catppuccin Mocha palette only
  • Style: Flat, minimal, geometric shapes

Acceptance Criteria

  • kindred-icons/ directory created with proper structure
  • Icon search path configured to load custom icons first
  • Test icon override working (e.g., document-save.svg)
  • Documentation added for adding new icons
  • Parent of Phase 1, 2, 3 icon migration issues
## Overview Set up the infrastructure to support custom Catppuccin Mocha themed icons that override the default FreeCAD icons. ## Goals 1. Create a `kindred-icons/` directory structure for custom icons 2. Configure FreeCAD's icon search path to prioritize custom icons 3. Establish the icon naming convention that matches FreeCAD's expectations 4. Document the override mechanism for future icon additions ## Technical Approach - Use FreeCAD's `BitmapFactory` search path system - Add custom icon path via `User parameter:BaseApp/Preferences/Bitmaps` - Icons in `kindred-icons/` will be loaded before compiled resources ## Icon Design Standards All Kindred Create icons must follow these guidelines: - **ViewBox**: 32x32 - **Background**: Rounded rectangle (`rx=4`) with `surface0` color (`#313244`) - **Stroke width**: 1.5-2.5 for main elements - **Colors**: Catppuccin Mocha palette only - **Style**: Flat, minimal, geometric shapes ## Acceptance Criteria - [ ] `kindred-icons/` directory created with proper structure - [ ] Icon search path configured to load custom icons first - [ ] Test icon override working (e.g., document-save.svg) - [ ] Documentation added for adding new icons ## Related Issues - Parent of Phase 1, 2, 3 icon migration issues
forbes referenced this issue from a commit 2026-02-14 16:31:26 +00:00
forbes referenced this issue from a commit 2026-02-14 16:34:29 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kindred/create#3