IconFlow

Open source · local-first · agent-native

One master.
Every surface.
Proven at 16px.

IconFlow turns product intent and one editable SVG into a reviewed icon family for the web, PWA, desktop, and system tray—with a quality gate that refuses weak pixels.

Start with IconFlow Inspect the proof
20
structural techniques
6
review axes
100
reviewed gallery cases
semantic SVG
IconFlow Petal Haypile mark
review gate passed · 6/6

The expensive mistake

An icon is not finished at 1024px.

Details close. Counters vanish. Tray silhouettes become black squares. IconFlow makes the smallest output the first-class design surface—not the final surprise.

IconFlow icon at 128 pixels
128
IconFlow icon at 64 pixels
64
IconFlow icon at 32 pixels
32
IconFlow icon at 16 pixels
16px

Interactive Proof Lab

Do not trust the mockup.
Inspect the pixels.

These are exact Chromium-rendered PNGs from the approved semantic source. Change the size, surface, crop, or source state.

Native size
Surface
Target crop
Actual size
IconFlow icon actual-size proof
16 × 16 px
16× pixel zoom
Magnified native pixels
counter open · gate detached · silhouette stable

A decision workflow, not a converter

Design. Review. Ship.
Then learn.

Generators make options. Converters make files. IconFlow makes the design decision visible, repeatable, and auditable.

  1. 01

    Brief

    Record the user job, essence, palette, clichés, and exact targets.

  2. 02

    Explore

    Force four different concepts and give the strongest one an ownable device.

  3. 03

    Compare

    Bake finalists into one silhouette-first sheet. Choose shape before polish.

  4. 04

    Inspect

    Review native pixels, alpha, crops, light/dark surfaces, and real targets.

  5. 05

    Ship

    Build only when automated QA is clean and every human score is at least 4/5.

  6. 06

    Learn

    Turn every failed pass into a reusable casebook rule for the next icon.

One pipeline · many worlds

Not another grid
of the same subject.

Relationships, companions, habits, original characters, games, collaboration, and folklore each begin with a different user job—then earn a silhouette that still reads at 16px.

Technique proofSame object

The Flow Gate stays fixed so construction—not subject matter—is the only variable.

Theme worldsDifferent objects

Every case below changes the job, noun, signature device, palette, and technique.

01 · Relationship / woven

Keepsake Knot

Two people keep one ritual tangible. No heart, chat bubble, or linked-circle shorthand—just two unequal bands sharing one offset opening.

Signature · shared asymmetric crossing
Keepsake Knot icon with teal and coral bands woven around an offset opening
02 · Cat / clay

Catnap Focus

A curled companion turns settling down into one warm gesture. Its tail leaves a broad time wedge beside the sleeping face.

Signature · tail-to-cheek wedge
Catnap Focus icon showing a clay-like curled sleeping cat
03 · Dog / line mark

Trail Tail

The dog is the route: one continuous walking contour, one open belly counter, one off-axis coral clasp. No paw or map pin.

Signature · route becomes companion
Trail Tail icon drawn as one continuous side-view dog contour
04 · Fish / stained glass

Koi Return

A single side-view koi makes daily practice feel like swimming upstream. Three bright panes meet one edge-open current cut.

Signature · upstream wake gate
Koi Return icon with a stained-glass side-view koi swimming upstream
05 · Original story / cel shaded

Quiet Hero

An original persona with no franchise imitation. The asymmetric profile crest and high collar identify the character before the face does.

Signature · crest meets collar notch
Quiet Hero icon showing an original cel-shaded character in asymmetric profile
06 · Original story / ink brush

Sky Courier

A spoiler-free chapter alert becomes a hand-carried dispatch. The satchel flap rises into one swept wing; the broad dry cut stays open at 16px.

Signature · the prop carries the motion
Sky Courier icon showing an ink-brush messenger satchel whose flap becomes a wing
07 · Collaboration / glass stack

Co-op Lock

Two uneven teammates become ready together. Their translucent keycaps share one opaque square counter—no controller, check, or avatar pair.

Signature · one counter, two arrivals
Co-op Lock icon with two unequal glass keycaps sharing one opaque square counter
08 · Animal folklore / woodcut

Forest Familiar

A carved horned owl guides a small companion home. Unequal ear tufts and a split tail name the bird; two edge-open gouges only describe the print.

Signature · species before texture
Forest Familiar icon showing a horned owl carved as a woodcut relief field
09 · Game / chrome

Boss Helm

A hard-won raid memory without a trophy, crown, sword, or gamepad. One horn is structurally missing; the ember fracture explains the scar.

Signature · damage changes silhouette
Boss Helm icon with hard chrome bands, ember visor, and one broken horn

One hundred admitted cases turn the method into practical reference: different user jobs, subjects, themes, techniques, and structural signatures.

Explore all 100 cases

Twenty visual languages · one fixed test object

Same subject on purpose.
Different construction.

The Flow Gate repeats here as a controlled specimen: holding the noun constant exposes each technique's topology, 16px contract, and monochrome strategy. The Theme Worlds above prove the system is not limited to that subject.

Woven technique scaffold
Relationships

Woven

Interlaced bands with explicit knockout gaps.

Glass stack technique scaffold
Collaboration

Glass stack

Translucent planes around an opaque skeleton.

Cel shaded technique scaffold
Original stories

Cel shaded

One ink contour and one decisive shadow plane.

Ink brush technique scaffold
Craft & culture

Ink brush

A tapered gesture with one broad dry cut.

Chrome technique scaffold
Games & music

Chrome

Six hard value bands inside one solid contour.

Woodcut technique scaffold
Animals & folklore

Woodcut

A closed relief mass with edge-open gouges.

Plus flat geometry, glow, line, mascot, duotone, stencil, pixel, isometric, cut paper, enamel, blueprint, stained glass, risograph, and clay.

The proof is visible

Every claim has
an artifact behind it.

IconFlow concept bake-off comparing three candidates across native sizes and silhouettes
01 · Compare

Concept bake-off

The Flow Gate beat a generic aperture and an F monogram in silhouette.

IconFlow review sheet showing native sizes, pixel zoom, silhouettes, and adaptive crops
02 · Inspect

Target-aware review

Actual pixels, not a decorative device mockup.

$ iconflow ship \
  --config iconflow.toml \
  --review master-review.json

✓ source hash matches
✓ 0 automated warnings
✓ all six axes ≥ 4/5

23 files built
03 · Ship

Fail-closed release

A stale receipt or weak score stops the build.

Run the five-minute proof

Your icon deserves
an honest final mile.

Choose the agent-assisted path or drive the CLI directly, then build the checked-in IconFlow brand family. No image API, account, or cloud renderer required.

Open Getting Started View on GitHub

PowerShell

git clone https://github.com/snowyukitty/ai-iconflow.git
cd ai-iconflow
python -m venv .venv
.venv\Scripts\python.exe -m pip install .
.venv\Scripts\python.exe -m iconflow doctor

The complete catalog

20 structural techniques

All twenty IconFlow technique scaffolds with native 16 pixel proofs