# 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.