create-app-icon

Generate AI app icons and wire them into your Expo project in one command.

npx create-app-icon

Run it inside an Expo project. You'll be prompted to describe the icon, pick a style, and pick a background. The CLI then:

1. Calls the hosted backend at https://ai-app-icons.fly.dev to generate the icon and all Expo asset sizes.
2. Writes PNGs into the directory that already holds your icon (read from the Expo config). Falls back to ./assets/ if no icon is set. Files written: icon.png, icon-ios.png, icon-ios-dark.png, icon-ios-tinted.png, adaptive-foreground.png, adaptive-background.png, adaptive-monochrome.png, splash.png, splash-icon.png, favicon.png.
3. Patches your Expo config file in place.

Overwrites

Assets are written with those fixed filenames. Any existing file with the same name in the output directory is overwritten — there is no backup. Before writing, the CLI lists every collision and asks you to confirm. Pass --force (or -y) to skip that prompt.

Supported config files (auto-detected, in Expo's resolution order):

• app.config.ts
• app.config.js
• app.config.json
• app.json

Options

--output <dir>     Asset output directory. Defaults to the folder that already
                   holds your icon (from the Expo config); falls back to
                   ./assets.
--config <file>    Explicit Expo config path (default: auto-detect)
--api-url <url>    Override backend URL
--web              Force the browser wizard (auto-enabled when the backend
                   requires auth)
--yes, -y          Skip the confirmation prompt
--force, -f        Alias for --yes. Skips confirmation even when existing
                   PNGs would be overwritten.
--help, -h         Show help
--version, -v      Show version

Environment: AI_APP_ICONS_API_URL overrides the backend URL, same as --api-url.

When it can't patch automatically

For app.config.js / app.config.ts, we look for a direct object literal export, module.exports = { ... }, or an arrow-function form returning an object literal. If your file does something more unusual (dynamic branches, imported config, etc.), the CLI will print the exact JSON snippet to add and leave the file untouched.

Develop

pnpm install
pnpm build
node dist/index.js --help