@profullstack/favicon-generator
github.com
What it is
@profullstack/favicon-generator creates icon files for iOS and progressive web apps from SVG or PNG source images. Its standard outputs include Apple Touch Icons sized from 57×57 to 180×180 and PWA icons from 192×192 to 512×512. Users can also request 16×16 and 32×32 favicons, or disable favicon generation. JPG is not supported. The package includes a command-line interface with interactive operation and options for image quality, compression, output directory, and silent mode. Developers can call its ESM functions, `generateIcons` and `generateCustomIcons`, and configure PNG quality, compression, favicon sizes, and custom icon sizes. Installation is available with pnpm, npm, or yarn, including global installation for the CLI. It requires Node.js 20 or later and ESM support. The README recommends a square PNG of at least 512×512; a smaller or non-square PNG triggers a warning, though generation continues with upscaling and padding. The repository uses the MIT license, and its README points users to GitHub for issues and questions.
Spec sheet
- Purpose
- Generates PNG icons from an SVG or PNG source for iOS and PWA compatibility.Read 8 Oct 2026 · github.com
- Support
- The README directs users to file issues or questions in the GitHub repository.Read 8 Oct 2026 · github.com
- License
- The repository is licensed under MIT.Read 8 Oct 2026 · github.com
- Maker
- The GitHub organization describes Profullstack, Inc. as an agentic engineering firm building web apps, developer tools, and agent infrastructure.Read 8 Oct 2026 · github.com
- CLI
- Includes a command-line interface with interactive mode and options for quality, compression, output directory, and silent operation.Read 8 Oct 2026 · github.com
- Configuration
- PNG quality, compression level, favicon sizes, and custom icon sizes can be configured.Read 8 Oct 2026 · github.com
- Dependencies
- Lists sharp for image processing and inquirer for interactive CLI prompts.Read 8 Oct 2026 · github.com
- Distribution
- The package can be installed with pnpm, npm, or yarn, including global installation for the CLI.Read 8 Oct 2026 · github.com
- Favicons
- It can generate 16×16 and 32×32 favicon sizes, and favicon generation can be disabled.Read 8 Oct 2026 · github.com
- Icon outputs
- Generates Apple Touch Icons, PWA icons, and optional 16×16 and 32×32 favicon sizes.Read 8 Oct 2026 · github.com
- Icon sizes
- Default outputs include Apple Touch Icons from 57×57 to 180×180 and PWA icons from 192×192 to 512×512.Read 8 Oct 2026 · github.com
- Input formats
- Accepts SVG and PNG source files; JPG is not supported.Read 8 Oct 2026 · github.com
- Input limitation
- Supported source files are SVG and PNG; the README recommends square PNG input of at least 512×512.Read 8 Oct 2026 · github.com
- Maker description
- Profullstack describes itself as an agentic engineering firm that builds web apps, developer tools, and agent infrastructure.Read 8 Oct 2026 · github.com
- Maker location
- The profullstack GitHub organization lists San Francisco, California.Read 8 Oct 2026 · github.com
- Programmatic use
- Provides ESM functions `generateIcons` and `generateCustomIcons` for programmatic icon generation.Read 8 Oct 2026 · github.com
- Requirements
- The README lists Node.js 20 or later and ESM support as requirements.Read 8 Oct 2026 · github.com
- Runtime requirement
- Requires Node.js 20 or later and ESM support.Read 8 Oct 2026 · github.com
- Source image limit
- PNG input smaller than the largest requested icon or not square triggers a warning; generation continues with upscaling and padding.Read 8 Oct 2026 · github.com
Strong points and limits
Strong points
- Generates Apple Touch and PWA icon sizes
- Includes CLI and programmatic ESM functions
- Supports custom icon sizes
- Can be installed with pnpm, npm, or yarn
Limits
- JPG input is unsupported
- Requires Node.js 20 or later and ESM support
- Small or non-square PNGs trigger a warning
Who it suits
This tool suits developers generating iOS and PWA icons from SVG or PNG assets, especially those who want CLI or programmatic use. Users need Node.js 20 or later and ESM support.
Verdict
The package offers configurable icon generation through both a CLI and programmatic functions. Source format and Node.js requirements are the main constraints to check first.
Where Specifiction places it
- Favicon Generators#29 of 306.8