T

yyc12345 1da4fc9293 feat: update assemblicon all in one

after doing some exploration for assemblicon architecture in aurora-iconset project,
we decide peel it off from aurora-iconset as an independent project.

the git log history is stored in aurora-iconset project and I don't want to migrate them.
the history of these commited code can be tracted by commit
93b48f22647265cc9efd87f52850f0511319672c..72edad6edca32333b5bd3b1668cd2837d770e4aa
in SarasasChipWorkshop/aurora-iconset.

2026-09-09 20:06:39 +08:00

src/assemblicon

feat: update assemblicon all in one

2026-09-09 20:06:39 +08:00

.gitignore

feat: initialize project

2026-08-18 13:01:45 +08:00

.python-version

feat: initialize project

2026-08-18 13:01:45 +08:00

pyproject.toml

feat: use source-sink design

2026-08-20 16:10:07 +08:00

README.md

feat: use source-sink design

2026-08-20 16:10:07 +08:00

uv.lock

feat: use source-sink design

2026-08-20 16:10:07 +08:00

README.md

Assemblicon

"Stop clicking 'Export' 50 times. Write a recipe and let Assemblicon do the assembly."

The Programmatic Icon Assembly Workflow. Treat your icons like code. Built for designers who think like engineers.

Philosophy

Assemblicon transforms the traditional design workflow into a compilation-like pipeline:

Source Code: Binary jpg, png image assets & Inkscape .svg primitives & Blender .blend 3D assets & etc...
Compiler Flags: Interactive CLI parameters (color, style, variant)
Linker: Python + Pillow (layering & alpha composition)
Binary Output: Final .png / .ico / .icns icon sets

Instead of manually tweaking 100 artboards, you define reusable components once and compile them on-demand with different arguments just like compiling a C program.

Features

Reproducible Builds: Every output is fully deterministic; store only the recipe, not the PNGs.
Batch Assembly: Define a recipe to generate entire icon families (light/dark, active/disabled, sizes) in one go.
Unlimited Customization: User defined recipe is actually a Python script utilizing Assemblicon. We can achieve any forms of composition which gives our unlimited customization ability.
Selective Build: User can only compile some specific icons of the whole defined icon set. This gives the ability of checking the built icon in resource-saving way.
License Backtrace: By defining the source and sink for icons, we can trace the license info (if user provide it) and produce the correct license info of final output.

License

This project is under MIT license.