code-drawn-art-and-icons
Draws Pocket Arcade art in code - 41 Toybox icons, Icon, game logos, GAME_ART and credits, LogoTile, app icon and splash via headless Skia. Use when adding an icon, logo, app icon or splash, or an image or emoji appears. Not for colours (toybox-design-system) or boards (board-rendering-skia).
- License 许可
- MIT
- 最近更新
- 2026-11-05
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- code-drawn-art-and-icons
- description
- Draws Pocket Arcade art in code - 41 Toybox icons, Icon, game logos, GAME_ART and credits, LogoTile, app icon and splash via headless Skia. Use when adding an icon, logo, app icon or splash, or an image or emoji appears. Not for colours (toybox-design-system) or boards (board-rendering-skia).
02 资源文件 358
- 资产文件assets/reference/icons-design.png23.8 KB
- 资产文件assets/reference/line-siege-android-art.png38.9 KB
- 资产文件assets/reference/line-siege-app-art.png158.1 KB
- 资产文件assets/reference/logos-design.png145.4 KB
- 资产文件assets/shared.json144 B
- 资产文件assets/toybox-tokens.json103.1 KB
- 脚本examples/flock-tilt-logo-art.ts894 B
- 脚本examples/scrap-shove-logo-art.ts799 B
- 脚本examples/swap-guard-logo-art.ts541 B
- 参考文档references/app-icon-and-splash.md11.9 KB
- 参考文档references/icon-catalogue.md9.7 KB
- 参考文档references/icon-system.md8.9 KB
- 参考文档references/logos-and-pictures.md12.2 KB
- 参考文档references/skia-notes.md5.6 KB
- 脚本scripts/check-app-art.mjs16.5 KB
- 脚本scripts/check-icons-and-logos.mjs18.5 KB
- 脚本scripts/check-lib.mjs44.4 KB
- 脚本scripts/lib/art-expectations.mjs3.5 KB
- 脚本scripts/lib/icon-coverage.mjs4.2 KB
- 脚本scripts/lib/png.mjs3.4 KB
- 脚本scripts/lib/svg-path.mjs7.3 KB
- 脚本scripts/selftest.mjs543 B
- 脚本templates/apps/__GAME_ID__/src/art/game-art.ts717 B
- 脚本templates/apps/__GAME_ID__/src/art/logo-art.test.ts1.7 KB
- 脚本templates/apps/line-siege/src/art/logo-art.test.ts899 B
- 脚本templates/apps/line-siege/src/art/logo-art.ts556 B
- 脚本templates/packages/shell/src/art/credit-entry.ts687 B
- 脚本templates/packages/shell/src/art/credit-rows.test.ts1.2 KB
- 脚本templates/packages/shell/src/art/credit-rows.ts1.4 KB
- 脚本templates/packages/shell/src/art/draw-logo.golden.test.ts1.6 KB
- 脚本templates/packages/shell/src/art/draw-logo.ts4.0 KB
- 脚本templates/packages/shell/src/art/game-art.ts1019 B
- 脚本templates/packages/shell/src/art/logo-art.test.ts1.4 KB
- 脚本templates/packages/shell/src/art/logo-art.ts2.4 KB
- 脚本templates/packages/shell/src/art/picture-ops.test.ts2.2 KB
- 脚本templates/packages/shell/src/art/picture-ops.ts4.1 KB
- 脚本templates/packages/shell/src/config/art-config.test.ts2.9 KB
- 脚本templates/packages/shell/src/config/art-config.ts3.4 KB
- 脚本templates/packages/shell/src/config/splash-grounds.ts386 B
- 脚本templates/packages/shell/src/game-host/sprite-cache.golden.test.ts3.5 KB
- 脚本templates/packages/shell/src/game-host/sprite-cache.ts3.1 KB
- 其他templates/packages/shell/src/ui/empty-stats-picture.test.tsx712 B
- 其他templates/packages/shell/src/ui/empty-stats-picture.tsx1.4 KB
- 其他templates/packages/shell/src/ui/hazard-strip.test.tsx746 B
- 其他templates/packages/shell/src/ui/hazard-strip.tsx1.6 KB
- 脚本templates/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本templates/packages/shell/src/ui/icons/icon-raster.golden.test.ts610 B
- 脚本templates/packages/shell/src/ui/icons/icon-raster.ts1.2 KB
- 其他templates/packages/shell/src/ui/icons/icon.test.tsx1.4 KB
- 其他templates/packages/shell/src/ui/icons/icon.tsx1.2 KB
- 其他templates/packages/shell/src/ui/logo-tile.test.tsx5.2 KB
- 其他templates/packages/shell/src/ui/logo-tile.tsx4.6 KB
- 其他templates/packages/shell/src/ui/picture-path.tsx918 B
- 脚本templates/packages/tooling/src/art/art-cli.test.ts2.4 KB
- 脚本templates/packages/tooling/src/art/art-cli.ts4.4 KB
- 脚本templates/packages/tooling/src/art/art-outputs.test.ts2.4 KB
- 脚本templates/packages/tooling/src/art/art-outputs.ts2.6 KB
- 脚本templates/packages/tooling/src/art/build-icon-paths.ts5.5 KB
- 参考文档templates/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本templates/packages/tooling/src/art/render-art.ts12.0 KB
- 脚本templates/packages/tooling/src/art/render-icon-sheet.ts3.0 KB
- 脚本templates/packages/tooling/src/visual/load-headless-skia.ts682 B
- 脚本tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/android-icon-foreground.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/android-icon-monochrome.png8.0 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/android-splash-icon-dark.png40.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/android-splash-icon.png40.9 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/play-icon-512.png5.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-android-adaptive-opaque/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-android-adaptive-opaque/EXPECT.txt81 B
- 脚本tests/fixtures/check-app-art/bad-android-adaptive-opaque/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/bad-android-adaptive-opaque/packages/shell/src/config/art-config.ts537 B
- 脚本tests/fixtures/check-app-art/bad-android-adaptive-opaque/packages/shell/src/config/splash-grounds.ts460 B
- 脚本tests/fixtures/check-app-art/bad-android-adaptive-opaque/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-android-missing/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-android-missing/EXPECT.txt287 B
- 脚本tests/fixtures/check-app-art/bad-android-missing/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/bad-android-missing/packages/shell/src/config/art-config.ts537 B
- 脚本tests/fixtures/check-app-art/bad-android-missing/packages/shell/src/config/splash-grounds.ts460 B
- 脚本tests/fixtures/check-app-art/bad-android-missing/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/android-icon-monochrome.png8.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-android-monochrome/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-android-monochrome/EXPECT.txt77 B
- 脚本tests/fixtures/check-app-art/bad-android-monochrome/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/bad-android-monochrome/packages/shell/src/config/art-config.ts537 B
- 脚本tests/fixtures/check-app-art/bad-android-monochrome/packages/shell/src/config/splash-grounds.ts460 B
- 脚本tests/fixtures/check-app-art/bad-android-monochrome/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/android-icon-foreground.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/android-splash-icon.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/play-icon-512.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-android-safe-area/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-android-safe-area/EXPECT.txt242 B
- 脚本tests/fixtures/check-app-art/bad-android-safe-area/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/bad-android-safe-area/packages/shell/src/config/art-config.ts537 B
- 脚本tests/fixtures/check-app-art/bad-android-safe-area/packages/shell/src/config/splash-grounds.ts460 B
- 脚本tests/fixtures/check-app-art/bad-android-safe-area/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-android-unwired/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-android-unwired/EXPECT.txt218 B
- 脚本tests/fixtures/check-app-art/bad-android-unwired/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/bad-android-unwired/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-android-unwired/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-android-unwired/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/assets/generated/icon-dark.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-dark-opaque/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-dark-opaque/EXPECT.txt31 B
- 脚本tests/fixtures/check-app-art/bad-dark-opaque/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-dark-opaque/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-dark-opaque/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-generated-header/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-generated-header/EXPECT.txt63 B
- 脚本tests/fixtures/check-app-art/bad-generated-header/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-generated-header/packages/shell/src/config/splash-grounds.ts339 B
- 脚本tests/fixtures/check-app-art/bad-generated-header/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/assets/generated/icon-light.png8.0 KB
- 资产文件tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-light-alpha/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-light-alpha/EXPECT.txt66 B
- 脚本tests/fixtures/check-app-art/bad-light-alpha/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-light-alpha/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-light-alpha/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-missing/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-missing/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-missing/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-missing/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-missing/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-missing/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-missing/EXPECT.txt62 B
- 脚本tests/fixtures/check-app-art/bad-missing/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-missing/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-missing/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/assets/generated/icon-light.png8.0 KB
- 资产文件tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-safe-area/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-safe-area/EXPECT.txt57 B
- 脚本tests/fixtures/check-app-art/bad-safe-area/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-safe-area/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-safe-area/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-size/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-size/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-size/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-size/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-size/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-size/apps/demo-game/assets/generated/splash-logo.png1.1 KB
- 参考文档tests/fixtures/check-app-art/bad-size/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-size/EXPECT.txt44 B
- 脚本tests/fixtures/check-app-art/bad-size/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-size/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-size/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/assets/generated/splash-logo-dark.png5.8 KB
- 资产文件tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-splash-edge/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-splash-edge/EXPECT.txt37 B
- 脚本tests/fixtures/check-app-art/bad-splash-edge/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-splash-edge/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-splash-edge/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-tinted-colour/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/bad-tinted-colour/EXPECT.txt34 B
- 脚本tests/fixtures/check-app-art/bad-tinted-colour/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-tinted-colour/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/bad-tinted-colour/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/bad-unwired/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/bad-unwired/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/bad-unwired/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/bad-unwired/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/bad-unwired/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/bad-unwired/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/bad-unwired/apps/demo-game/package.json92 B
- 参考文档tests/fixtures/check-app-art/bad-unwired/EXPECT.txt211 B
- 脚本tests/fixtures/check-app-art/bad-unwired/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/bad-unwired/packages/shell/src/config/splash-grounds.ts442 B
- 脚本tests/fixtures/check-app-art/bad-unwired/packages/shell/src/config/with-shell.ts241 B
- 脚本tests/fixtures/check-app-art/good/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/android-icon-foreground.png8.3 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/android-icon-monochrome.png8.0 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/android-splash-icon-dark.png40.1 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/android-splash-icon.png40.9 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/play-icon-512.png5.1 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/good/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/good/apps/demo-game/package.json125 B
- 脚本tests/fixtures/check-app-art/good/packages/shell/src/config/android-config.ts187 B
- 脚本tests/fixtures/check-app-art/good/packages/shell/src/config/art-config.ts537 B
- 脚本tests/fixtures/check-app-art/good/packages/shell/src/config/splash-grounds.ts460 B
- 脚本tests/fixtures/check-app-art/good/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/app.config.ts233 B
- 资产文件tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/assets/generated/icon-dark.png6.2 KB
- 资产文件tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/assets/generated/icon-light.png6.8 KB
- 资产文件tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/assets/generated/icon-tinted.png7.1 KB
- 资产文件tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/assets/generated/splash-logo-dark.png7.3 KB
- 资产文件tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/assets/generated/splash-logo.png7.3 KB
- 参考文档tests/fixtures/check-app-art/pass-android-not-yet-due/apps/demo-game/package.json125 B
- 参考文档tests/fixtures/check-app-art/pass-android-not-yet-due/EXPECT.txt456 B
- 脚本tests/fixtures/check-app-art/pass-android-not-yet-due/packages/shell/src/config/art-config.ts268 B
- 脚本tests/fixtures/check-app-art/pass-android-not-yet-due/packages/shell/src/config/splash-grounds.ts441 B
- 脚本tests/fixtures/check-app-art/pass-android-not-yet-due/packages/shell/src/config/with-shell.ts295 B
- 脚本tests/fixtures/check-icons-and-logos/bad-bans/apps/line-siege/src/art/logo-art.ts556 B
- 资产文件tests/fixtures/check-icons-and-logos/bad-bans/apps/line-siege/src/art/sheep.png8 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-bans/EXPECT.txt117 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-bans/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-bans/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 其他tests/fixtures/check-icons-and-logos/bad-bans/packages/shell/src/ui/star-badge.tsx176 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-directional/EXPECT.txt97 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-directional/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-directional/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-directional/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-logo/apps/line-siege/src/art/game-art.ts677 B
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-logo/apps/line-siege/src/art/logo-art.ts556 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-logo/EXPECT.txt91 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-logo/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-logo/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-logo/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/bad-game-art-logo/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-logo/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-missing/apps/line-siege/src/art/logo-art.ts556 B
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-missing/apps/line-siege/src/index.ts63 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-missing/EXPECT.txt96 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-missing/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-missing/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-game-art-missing/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/bad-game-art-missing/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-game-art-missing/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/apps/line-siege/src/art/game-art.ts714 B
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/apps/line-siege/src/art/logo-art.ts556 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-generated-header/EXPECT.txt63 B
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/jest.setup.ts178 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-generated-header/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/packages/shell/src/ui/icons/icon-paths.ts128.2 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/packages/shell/src/ui/icons/icon-raster.ts174 B
- 脚本tests/fixtures/check-icons-and-logos/bad-generated-header/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/bad-generated-header/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-generated-header/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-grid/EXPECT.txt53 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-grid/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-grid/packages/shell/src/ui/icons/icon-paths.ts11.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-grid/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/apps/line-siege/src/art/game-art.ts714 B
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/apps/line-siege/src/art/logo-art.ts556 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/EXPECT.txt92 B
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/jest.setup.ts361 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/shell/src/ui/icons/icon-raster.ts174 B
- 脚本tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-icon-raster-unmocked/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-layers-drift/EXPECT.txt44 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-layers-drift/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-layers-drift/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-layers-drift/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-layers-missing/EXPECT.txt64 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-layers-missing/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-layers-missing/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-mismatch/apps/line-siege/src/art/logo-art.ts556 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-mismatch/EXPECT.txt65 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-mismatch/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-mismatch/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-missing/apps/sheep-sort/src/index.ts11 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-missing/EXPECT.txt43 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-missing/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-missing/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-shape/apps/sheep-sort/src/art/logo-art.ts147 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-shape/EXPECT.txt70 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-shape/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-shape/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/apps/line-siege/src/art/game-art.ts714 B
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/apps/line-siege/src/art/logo-art.ts556 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/EXPECT.txt98 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-logo-tile-drift/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-missing-icon/EXPECT.txt35 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-missing-icon/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-missing-icon/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-missing-icon/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-path-edit/EXPECT.txt60 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-path-edit/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-path-edit/packages/shell/src/ui/icons/icon-paths.ts483 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-path-edit/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-stale-path/EXPECT.txt53 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-stale-path/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-stale-path/packages/shell/src/ui/icons/icon-paths.ts13.1 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-stale-path/packages/tooling/src/art/icon-layers.json17.9 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-syntax/EXPECT.txt48 B
- 参考文档tests/fixtures/check-icons-and-logos/bad-syntax/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/bad-syntax/packages/shell/src/ui/icons/icon-paths.ts7.6 KB
- 参考文档tests/fixtures/check-icons-and-logos/bad-syntax/packages/tooling/src/art/icon-layers.json17.9 KB
- 脚本tests/fixtures/check-icons-and-logos/good/apps/line-siege/src/art/game-art.ts714 B
- 脚本tests/fixtures/check-icons-and-logos/good/apps/line-siege/src/art/logo-art.ts556 B
- 脚本tests/fixtures/check-icons-and-logos/good/jest.setup.ts178 B
- 参考文档tests/fixtures/check-icons-and-logos/good/packages/shell/package.json66 B
- 脚本tests/fixtures/check-icons-and-logos/good/packages/shell/src/ui/icons/icon-paths.ts128.3 KB
- 脚本tests/fixtures/check-icons-and-logos/good/packages/shell/src/ui/icons/icon-raster.ts174 B
- 脚本tests/fixtures/check-icons-and-logos/good/packages/shell/src/ui/label.ts79 B
- 其他tests/fixtures/check-icons-and-logos/good/packages/shell/src/ui/logo-tile.tsx3.7 KB
- 参考文档tests/fixtures/check-icons-and-logos/good/packages/tooling/src/art/icon-layers.json17.9 KB
03 SKILL.md 正文
Code-drawn art and icons
Makes every picture in a Pocket Arcade app come from code: the Shell's 41 Toybox icons as one Skia path each, each game's logo as 48-grid layers handed to the Shell in GAME_ART (with its board palettes and licence credits), the Shell pictures, and the app icon and splash rendered by headless Skia from the same logo and palette. Scripts prove the icon set, the logos, GAME_ART and the generated PNGs, and ban image files, emoji and icon fonts.
Rules that must hold
- Every UI icon is a Toybox glyph from
icon-paths.ts, drawn by<Icon>. Never react-native-svg, emoji, icon fonts or image files: the owner's rule is "drawn in code", react-native-svg adds a network-capable native pod, and one rasterized path per icon was measured 4.8x faster than a canvas per icon. icon-paths.tsis generated fromicon-layers.jsonbybuild-icon-paths.ts, never edited by hand. The layers are the design's source; a hand-edited path drifts from it silently (check-icons-and-logoscompares every path with its layers).- Only
back,chevron,forwardandundomirror in RTL.Iconflips them itself; play, pause, clocks, stars, the lock, logos and pictures never mirror. - Every game has a
LOGO_ARTon the 48 grid using the six roles (p,w,w0,k,kl,pl); every design game (Line Siege, Flock Tilt, Scrap Shove, Jump Chain, Stepstone, Toggle Drop, Trail Clear: the token file'slogos.games) uses its Toybox logo exactly. The logo is the brand on Home, About, the lose screen, the splash and the app icon. - This skill owns the art contract:
packages/shell/src/art/game-art.ts(GameArt=palettes,logo,credits),credit-entry.tsandcredit-rows.ts; each game'sGAME_ARTsetslogo: LOGO_ARTfrom./logo-art.tsand lists only its own credits. There is nodrawIcon: every picture of the game drawsLOGO_ART. Why: one data file is the whole brand, and the Shell reaches the logo and the licence rows only through the module. - Multi-colour art is one Skia canvas, at most 8 per screen outside the board, never one per list item. Each canvas costs about 0.18 MB and 2.8 ms; draw code imports Skia types only and takes the Skia API as a parameter so the same code runs in the app, goldens and Node.
- The app icon and splash come from
render-art.tsand are committed. 1024 x 1024; light opaque and full bleed; dark with a transparent background; tinted opaque grayscale; glyph inside the central 62 %; splash = the S1 logo tile.--checkkeeps them in step with the logo and palette. From Android step 2 (onceandroid-config.tsexists) it also writes the adaptive icon (android-icon-foreground.pngon transparency, glyph inside the 66 dp circle of 108 dp, background the game's accent;android-icon-monochrome.png, one white colour on alpha), the Android 12 splash icons (inside the 192 dp circle of 288 dp) and the opaqueplay-icon-512.png: a launcher masks the layer to any shape, and a glyph outside the safe circle is cut off. - A star rating is two stacked icons,
rating-fillinstarOnplusrating-edgeinborder(hollow: onlyrating-edgeinstarOff);star-filled/star-outlineare single-colour glyphs for tiles and rows. - Look at every generated image before committing. The icon contact sheet, and the five app PNGs at 1024 and 256 px: a check that the file is valid is not a check that it looks right.
- Board sprites are pre-rendered once per key (palette, scheme, colour-blind, cell size, pixel ratio), never redrawn per frame.
Workflow
- Read references/icon-system.md first: the decision, the layer model, the build pipeline,
Icon, sizes, tests. - Setting up (once). Copy from
templates/:packages/tooling/src/art/(icon-layers.json, build-icon-paths.ts, render-icon-sheet.ts, render-art.ts, art-outputs.ts and its test, art-cli.ts and its test),packages/tooling/src/visual/load-headless-skia.ts,packages/shell/src/ui/icons/(icon-paths.ts, icon-raster.ts, icon.tsx and both tests),packages/shell/src/art/(logo, drawing, pictures,game-art.ts,credit-entry.ts,credit-rows.ts, tests;game-art.tsimportsPaletteSetfrom board-rendering-skia'sgame-host/board-kit.ts, so it lands with the board host, which pocket-arcade-index copies in the same Shell step 7),packages/shell/src/ui/(logo-tile, picture-path, empty-stats-picture, hazard-strip and their tests),packages/shell/src/game-host/sprite-cache*.tsandpackages/shell/src/config/(art-config, its test, splash-grounds). There is nothing to uncomment in the rootjest.setup.ts: its guarded mock (if (existsSync(...'packages/shell/src/ui/icons/icon-raster.ts')) jest.mock('@e07/shell/ui/icons/icon-raster.ts', ...), unit-and-component-tests' shared copy) turns itself on onceicon-raster.tsexists, because a mock of a missing module would fail every suite (icon-system.md, "Tests");check-icons-and-logos.mjsfailsicon-raster-mockonly when a repo'sjest.setup.tslost that guarded mock.splash-grounds.tsships empty on purpose (step 7 fills it). Every art script prints its usage with--helpand exits 2 with oneERROR:line on a bad flag. - Using an icon. Pick the name in references/icon-catalogue.md, the size from icon-system.md ("Sizes per component"), the colour from the theme; the surrounding button or row carries the label.
- Adding or changing an icon. Follow icon-system.md ("Adding or changing an icon"): layers into
icon-layers.json,node packages/tooling/src/art/build-icon-paths.ts,node packages/tooling/src/art/render-icon-sheet.ts, then look at the sheet next to assets/reference/icons-design.png. - A game's logo and GAME_ART. Read references/logos-and-pictures.md. Painted games: copy
templates/apps/line-siege/src/art/logo-art.ts, examples/flock-tilt-logo-art.ts, examples/scrap-shove-logo-art.ts or examples/swap-guard-logo-art.ts (every game a design pass painted) toapps/<game>/src/art/logo-art.ts. A new game: design one with "Designing a logo for a new game" and compare its look with assets/reference/logos-design.png. Every logo lands with its test in the same commit (tdd-workflow'scheck-test-editsfails a feat commit whose code has no test): Line Siege copiestemplates/apps/line-siege/src/art/logo-art.test.ts(its pinned paint order), any other game copiestemplates/apps/__GAME_ID__/src/art/logo-art.test.tstoapps/<game>/src/art/logo-art.test.tswith__GAME_ID__replaced (the recipe's rules: one or two pop accents, toy ink, at most eight layers, every layer starting inside the grid's 2-unit margin) and adds oneitthat pins its own paint order, as Line Siege's does. Show a new logo to the owner. Then copytemplates/apps/__GAME_ID__/src/art/game-art.tstoapps/<game>/src/art/game-art.ts, replace__GAME_ID__, runnpx eslint --fixon it (the import order depends on the game id), and add aCreditEntryfor every font or word list the game ships beyond the Shell's ("GAME_ART" in logos-and-pictures.md); the game-host-integration skill assembles it aspresentation.art. - Shell pictures.
LogoTile(five variants),EmptyStatsPicture(S10) andHazardStrip(S15) are in the templates; their specs are in logos-and-pictures.md. - App icon and splash (before the first simulator build). Read references/app-icon-and-splash.md, "Expo config", and keep its order: first
npx expo install expo-splash-screenin every app (and"expo-splash-screen": "*"in the Shell'speerDependencies), then, with the game'sLOGO_ARTand palette (apps/<game>/src/theme/palette.ts) in place,node packages/tooling/src/art/render-art.ts --app <game>(it writes the ten PNGs ofart-outputs.tsand adds the game's grounds and accent tosplash-grounds.ts). Look at the PNGs at 1024 and 256 px (compare with assets/reference/line-siege-app-art.png and, for Android, assets/reference/line-siege-android-art.png).withShellends inwithGameArt(config, game.id)(architecture-and-boundaries' finalwith-shell.ts; never editapp.config.ts). Only then runnpx expo config, prebuild or a build; commit the PNGs andsplash-grounds.tstogether with the art render, in one commit. Every file the art tools generate carries// GENERATED by <tool path>within its first three lines (splash-grounds.ts:// GENERATED by packages/tooling/src/art/render-art.ts;icon-paths.ts:// GENERATED by packages/tooling/src/art/build-icon-paths.ts), so the test-edit check (tdd-workflow'scheck-test-edits) does not report them as code without a test; never hand-edit them or drop that line (rulegenerated-header:check-app-artforsplash-grounds.ts,check-icons-and-logosforicon-paths.ts). - Sprites or Skia questions (headless loading, Jest projects, fonts in Skia): references/skia-notes.md.
- Run the checks from the repo root and loop until all pass:
npx tsc --noEmitfor the touched projects,npx eslint <changed paths> --max-warnings 0,npx jest packages/shell/src/art packages/shell/src/ui packages/shell/src/config packages/tooling/src/art apps/<game>/src/art --ci --selectProjects unit --coverage --collectCoverageFrom='packages/shell/src/{art,config}/**/*.ts' --coverageThreshold='{}'(onlynpm run test:coveragejudges the thresholds) andnpx jest packages/shell/src/art packages/shell/src/ui packages/shell/src/game-host/sprite-cache.golden.test.ts --ci --selectProjects golden(paths first:--selectProjectsreads every later word as a project name),node packages/tooling/src/art/build-icon-paths.ts --check,node packages/tooling/src/art/render-art.ts --app <game> --check, then the two scripts below. - Report what was drawn or changed, with the 256 px images, and say plainly that the owner should look at any new logo or icon.
Definition of done
- [ ]
icon-paths.tswas generated fromicon-layers.json(build-icon-paths.ts --checkexits 0) and its contact sheet was looked at. - [ ] Every game with
src/has a validsrc/art/logo-art.ts; painted games match their Toybox logos; every assembled game hassrc/art/game-art.tswithlogo: LOGO_ARTand its own credits. - [ ] Every Expo app has the generated PNGs (five for iOS; from Android step 2 also the adaptive, monochrome, Android splash and Play icons),
render-art.ts --checkexits 0, they were looked at at 1024 and 256 px, its splash grounds are inpackages/shell/src/config/splash-grounds.ts,withShellends inwithGameArt, and the app depends onexpo-splash-screen. - [ ] No image file, image import, emoji, icon font or react-native-svg in app source.
- [ ] Once
icon-raster.tsexists, the rootjest.setup.tsmocks it (the unit project cannot load Skia). - [ ] Unit and golden Jest projects,
tscand ESLint (--max-warnings 0) pass for the touched code. - [ ]
node ${CLAUDE_SKILL_DIR}/scripts/check-app-art.mjs .printsRESULT: PASS(when an Expo app exists) - [ ]
node ${CLAUDE_SKILL_DIR}/scripts/check-icons-and-logos.mjs .printsRESULT: PASS
Anti-patterns
- Editing a path in
icon-paths.tsto "fix" an icon. The next generation overwrites it and the checker flags it as stale; change the layers and regenerate. - An emoji or a PNG "just for now". It ships, it breaks the drawn-in-code rule and the look; use an
Iconor a picture op. - A Skia canvas per level tile or row. Measured 4 to 5 times slower to lay out; rasterized icons in native images scale to hundreds.
- Mirroring the logo or the play icon in RTL. Objects and media controls keep their direction; only arrows that point along the reading direction flip.
- Committing icons or splash images without looking at them. Valid PNGs can still be blank, clipped or off-centre; open them.
- Importing Skia values in shared draw code. Node scripts then load React Native and fail; import types and take the API as a parameter.
- Drawing the app icon from a screenshot of the app. Render it from
LOGO_ARTand the palette so the icon, splash and in-app logo stay one design. - A second drawing of the logo for one screen (a
drawIconpainter, a PNG for the result screen). Screens gethost.logo(the module'sGAME_ART.logo) and draw it withLogoTile. - Listing the Shell's fonts or generated sounds in a game's credits. The Shell's rows already cover them; a duplicate row confuses the licences screen.
Files in this skill
| File | What it is | Read/run when |
|---|---|---|
| references/icon-system.md | Why rasterized paths, the layer model, build pipeline, Icon, sizes, mirroring, tests, adding an icon | Workflow step 1 |
| references/icon-catalogue.md | All 41 icons with names, use, mirroring and layers; the rating-star layers | Picking or changing an icon |
| references/logos-and-pictures.md | Logo grid and roles, the painted games' logos, new-logo recipe, logo tile variants, rating star, empty picture, hazard strip | Logos and Shell pictures |
| references/app-icon-and-splash.md | Outputs, Apple rules, the Toybox look of each variant, render-art, Expo config, review | App icon, splash, store art |
| references/skia-notes.md | Where Skia runs, headless loading, APIs, declarative drawing, Jest projects, fonts, sprites | Any Skia question |
templates/packages/tooling/src/art/ |
icon-layers.json, build-icon-paths.ts, render-icon-sheet.ts, render-art.ts, art-outputs.ts (every output with its size and the Android geometry) and its test, art-cli.ts (--help, bad-flag errors, exit codes) and its test |
Workflow steps 2, 4, 7 |
templates/packages/tooling/src/visual/load-headless-skia.ts |
Headless Skia loader for Node scripts | Workflow step 2 |
templates/packages/shell/src/ui/icons/ |
icon-paths.ts (generated, 44 entries), icon-raster.ts, icon.tsx, icon.test.tsx, icon-raster.golden.test.ts | Workflow step 2 |
templates/packages/shell/src/art/ |
logo-art.ts, draw-logo.ts, picture-ops.ts, game-art.ts (GameArt), credit-entry.ts, credit-rows.ts (creditRowsOf) and their tests (unit and golden) |
Workflow steps 2, 5, 6 |
templates/packages/shell/src/ui/ |
logo-tile, picture-path, empty-stats-picture, hazard-strip (with tests) | Workflow step 6 |
templates/packages/shell/src/game-host/ |
sprite-cache.ts and its golden test | Sprites |
templates/packages/shell/src/config/ |
art-config.ts (ICON_CONFIG with the Android adaptive layers, splashPlugin() with the Android 12 icon, withArt(), withGameArt()), its test, and splash-grounds.ts (ships empty; render-art.ts adds each drawn game) |
Workflow steps 2 and 7 |
templates/apps/line-siege/src/art/logo-art.ts |
Line Siege's LOGO_ART | Workflow step 5 |
templates/apps/line-siege/src/art/logo-art.test.ts |
Its test: the pinned paint order, no rotated layer | Workflow step 5 (copy with the logo) |
templates/apps/__GAME_ID__/src/art/logo-art.test.ts |
Any game's logo test: the logo recipe's rules (pop accents, toy ink, layer count, grid margin) | Workflow step 5 (copy with a new logo) |
templates/apps/__GAME_ID__/src/art/game-art.ts |
A game's GAME_ART (palettes, logo: LOGO_ART, credits) |
Workflow step 5 |
| examples/flock-tilt-logo-art.ts | Flock Tilt's LOGO_ART (rotated layers) | Workflow step 5 |
| examples/scrap-shove-logo-art.ts | Scrap Shove's LOGO_ART | Workflow step 5 |
| examples/swap-guard-logo-art.ts | Swap Guard's LOGO_ART (its design pass) | Workflow step 5 |
| assets/reference/icons-design.png | The 44 icons as the design draws them (ICON_PATHS order, 8 per row) | Reviewing icons |
| assets/reference/logos-design.png | The three S1 logo tiles, light and dark, as the design draws them | Reviewing logos |
| assets/reference/line-siege-app-art.png | The five generated Line Siege PNGs at 256 px | Reviewing app art |
| assets/reference/line-siege-android-art.png | Line Siege's Android outputs with their safe circles, and the Play icon | Reviewing Android art |
assets/toybox-tokens.json |
The Toybox token file (icons, logos, component sizes) | Read by the scripts |
assets/shared.json |
Declares the shared files this skill copies in | When adding a shared file |
scripts/check-icons-and-logos.mjs |
Checker: icon set, paths vs layers, directional set, logos, GAME_ART.logo, LogoTile numbers vs tokens, image/emoji/svg bans, the icon-raster mock in jest.setup.ts, the GENERATED by line of icon-paths.ts (generated-header) |
Workflow steps 2 and 9 |
scripts/check-app-art.mjs |
Checker: the generated PNGs per app (size, alpha, grayscale, safe area; from Android step 2 the adaptive, monochrome, Android splash and Play icons), the wiring (withGameArt in the Shell config, splash grounds, expo-splash-screen) and the GENERATED by line of splash-grounds.ts (generated-header) |
Workflow step 9 |
scripts/lib/ |
SVG path reader, icon coverage sampler (a path vs its layers), PNG reader, Toybox art expectations (used by the scripts) | Never directly |
scripts/selftest.mjs |
Proves both checkers on good and planted-bad fixtures | After changing a checker |
scripts/check-lib.mjs |
Shared script helper, synced from the library (do not edit here) | Never by hand |
tests/fixtures/ |
Good and planted-bad inputs for the self-test | When adding a rule |
Related skills
toybox-design-system- the palettes, printed colours and fonts the art uses.toybox-components- the components that place icons, stars and logo tiles.game-host-integration- assemblesGAME_ARTaspresentation.artand handslogoandcreditsto screens.toybox-screens- the Result, Home, About and Licences screens that draw the logo and list the credits.board-rendering-skia- board pictures, timelines and pixel goldens.toybox-visual-parity- compares built screens with the design screenshots.ios-release-testflight- the build that carries the icon and splash.
04 同仓库更多 Skills
unit-and-component-tests
Sets up Jest and writes Pocket Arcade test code - three projects, RNTL 14 async via renderWithShell, root SDK mocks, fakes, fast-check, coverage, Stryker. Use when a test needs the Shell wrapper, a mock or a fake, or Jest fails. Not for the red-green loop (tdd-workflow) or goldens (golden-tests).
typescript-and-lint-rules
Enforces Pocket Arcade's strict TypeScript 6 tsconfigs, ESLint 9 flat config, Prettier and size limits. Use when writing or splitting .ts/.tsx or fixing a tsc or lint error. Not for gate wiring (quality-gates), names (naming-conventions) or import zones (architecture-and-boundaries).
demo-skill
Builds a demo. Use when testing the pitfall checker.
demo-skill
Builds a demo. Use when testing the pitfall checker.
troubleshooting-playbook
Diagnoses and fixes Pocket Arcade failures with a catalogue of 300+ known ones (symptom, cause, fix). Use when something errors, crashes, hangs or renders wrong, or an error or log needs explaining. Not for gate setup (quality-gates) or running builds (ios-simulator-build, ios-release-testflight).
toybox-visual-parity
Proves a built Pocket Arcade screen matches its Toybox design screenshot (light/dark, en/fa) and drives the fixes: capture, element gates, sheets, sign-off. Use when any screen is built or changed, or for visual parity, design match, screenshot compare. Not for building screens (toybox-screens).