mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-10 21:07:03 +01:00
Krzysztof kuhy Rudnicki
1c50cfb028
Some checks failed
dependency freshness / dependencies on newest stable (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (mypy, mypy) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (pylint, pylint) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (rest, ) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (shellcheck, shellcheck) (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
Shell tests / shell-tests (push) Waiting to run
Shell tests / lib-tests (push) Waiting to run
Shell tests / arch-tests (push) Waiting to run
Python tests / test (push) Has been cancelled
New `lightbulb` glyph (filled bulb over a two-bar screw base) in a new _glyph_art_extra.py module, registered for ~/src/tutor/app. `generate --web` overwrites a Flutter app's web/favicon.png and web/icons/Icon-*.png from the same registry entry; the maskable variants reuse the full render because SAFE_BOX fits inside the 40% maskable safe circle. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YADHKXzZhhePzQ2rNoXFcK
3.1 KiB
3.1 KiB
app_icons — shared launcher icons for the Flutter apps
One icon family across every Flutter/Dart app: a charcoal #211D1B field with
a single glyph in the shared unified-design-system accent (#B8862E),
drawn at one stroke weight and optically centred so a row of them lines up.
Commands
# what is registered
PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons list
# contact sheet for visual review: full size / circle-masked / 48dp
PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons preview -o /tmp/sheet.png
# write assets into every app repo and rebuild the Android mipmaps
PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons generate --android
# one app, plus the hicolor PNGs for a Linux desktop target
PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons \
generate --app todo --android --linux-out ~/src/todo/linux/icons
# overwrite web/favicon.png + web/icons/Icon-*.png (apps with a web/ dir);
# the maskable ones are safe because SAFE_BOX fits the 40% maskable circle
PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons \
generate --app tutor --android --web
What gets written
Per app, into <repo>/assets/icon/:
| Layer | Purpose |
|---|---|
icon |
Charcoal field + glyph. Legacy square launcher icon and Linux icon. |
icon_foreground |
Glyph only, transparent. Adaptive-icon foreground layer. |
icon_monochrome |
Glyph only, white. Android 13+ themed icons. |
Both an .svg source and a 1024px .png are written for each, so a build
never needs rsvg-convert. flutter_launcher_icons then turns the PNGs into
the density buckets and mipmap-anydpi-v26/ic_launcher.xml.
Design constraints that bite
- Negative space ≥ half the stroke weight. Strokes closer than that merge into a solid blob at launcher size. A fork whose tines sat exactly one stroke width apart rendered as a tulip.
- Ink must stay inside the 560px safe box. Android masks adaptive icons to
roughly the inner 66% of the canvas.
generatewarns when a glyph overflows. - Stroked outlines can read wrong. A stroked three-tine fork reads as a trident; a filled fork-and-knife pair reads as cutlery. Prefer a filled silhouette when the outline is ambiguous.
- Glyph positioning inside the fragment is irrelevant —
render.centre_offsetmeasures the rendered ink and recentres it. Only the extents matter.
Adding an app
See the app-icon skill (~/.claude/skills/app-icon/SKILL.md) for the full
procedure. In short: add a glyph to glyphs.py, register the app in
apps.py, wire flutter_launcher_icons into its pubspec.yaml, generate,
review the contact sheet, then verify on the phone.
Tests
cd ~/src/testsAndMisc
python3 -m pytest python_pkg/app_icons --cov=python_pkg.app_icons \
--cov-report=term-missing
External tools (rsvg-convert, magick, dart) are mocked; the suite needs
none of them installed.