Wholesale copy of all Kindred Create additions that don't conflict with upstream FreeCAD code: - kindred-icons/ (1444 Catppuccin Mocha SVG icon overrides) - src/Mod/Create/ (Kindred Create workbench) - src/Gui/ Kindred source files (FileOrigin, OriginManager, OriginSelectorWidget, CommandOrigin, BreadcrumbToolBar, EditingContext) - src/Gui/Icons/ (Kindred branding and silo icons) - src/Gui/PreferencePacks/KindredCreate/ - src/Gui/Stylesheets/ (KindredCreate.qss, images_dark-light/) - package/ (rattler-build recipe) - docs/ (architecture, guides, specifications) - .gitea/ (CI workflows, issue templates) - mods/silo, mods/ztools submodules - .gitmodules (Kindred submodule URLs) - resources/ (kindred-create.desktop, kindred-create.xml) - banner-logo-light.png, CONTRIBUTING.md
1.7 KiB
1.7 KiB
Contributing
Kindred Create is maintained at git.kindred-systems.com/kindred/create. Contributions are submitted as pull requests against the main branch.
Getting started
git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
cd create
pixi run configure
pixi run build
pixi run freecad
See Building from Source for the full development setup.
Branch and PR workflow
- Create a feature branch from
main:git checkout -b feat/my-feature main - Make your changes, commit with conventional commit messages (see below).
- Push and open a pull request against
main. - CI builds and tests run automatically on all PRs.
Commit messages
Use Conventional Commits:
| Prefix | Purpose |
|---|---|
feat: |
New feature |
fix: |
Bug fix |
chore: |
Maintenance, dependencies |
docs: |
Documentation only |
art: |
Icons, theme, visual assets |
Scope is optional but encouraged:
feat(ztools): add datum point creation modefix(gui): correct menu icon size on Waylandchore: update silo submodule
Reporting issues
Report issues at the issue tracker. When reporting:
- Note whether the issue involves Kindred Create additions (ztools, Silo, theme) or base FreeCAD
- Include version info from Help > About FreeCAD > Copy to clipboard
- Provide reproduction steps and attach example files (FCStd as ZIP) if applicable
For base FreeCAD issues, also check the FreeCAD issue tracker.