@joedoesstuff/favi

Thin CLI for the favi favicon API. No icon database and no local rasterizer — every command calls the public HTTP API.

Install

npm i -g @joedoesstuff/favi
# or
npx @joedoesstuff/favi search image

From this repo (unpublished):

node packages/cli/bin/favi.js --help

Usage

favi search image --library lucide --limit 8
favi export --library lucide --name image --style outline -o favicon.zip
favi install --library lucide --name image --dir web/public

Override the API base (local dev):

export FAVI_BASE_URL=http://127.0.0.1:8000
favi health

Or pass --base-url on any command.

Commands

| Command | Purpose | | --- | --- | | health | GET /api/health | | libraries | List packs + styles | | search <query> | Search icons | | export | Write a favicon zip | | install | Export + unzip into --dir (default public) |

Exit codes: 0 ok, 1 API/runtime error, 2 usage/input error, 3 not found.

Requires Node 18+ (fetch). install needs unzip on PATH.