# Favicon Generator: PWA Icons & OG Image from a Logo (`ferrolark/launch-asset-pack`) Actor

Favicon generator and OG image generator: one logo in, launch-ready files out. favicon.ico, PNG favicons, Apple touch icon, PWA and maskable icons, 1200x630 Open Graph image, site.webmanifest and HTML/Next.js head snippets in a ZIP. $0.02 per pack.

- **URL**: https://apify.com/ferrolark/launch-asset-pack.md
- **Developed by:** [Ferrolark](https://apify.com/ferrolark) (community)
- **Categories:** Developer tools, SEO tools, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$20.00 / 1,000 asset packs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Launch Asset Pack: Favicon, PWA Icons & OG Image from a Logo

Give it one logo and an app name. You get every icon and meta tag a web app needs before launch:

- `favicon.ico` plus 16 and 32 px PNG favicons
- Apple touch icon
- 192 and 512 px PWA icons and a maskable icon
- a 1200×630 Open Graph / Twitter card image
- `site.webmanifest`
- ready-to-paste `<head>` tags and a Next.js App Router `metadata` export

Everything comes in one ZIP, plus a manifest with each file's dimensions, size and SHA-256. The output is deterministic: no AI art, no account to create and nothing uploaded anywhere else.

### Real example

This input (Wikimedia's public `Example.svg` as the logo):

```json
{
  "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
  "appName": "Acme Notes",
  "description": "Fast notes that sync everywhere.",
  "siteUrl": "https://acme.app",
  "themeColor": "#0f766e"
}
```

produced these 11 files in **5 seconds** on Apify (512 MB memory, $0.00025 of platform usage):

| File | Size (px) | Bytes | Purpose |
|---|---|---:|---|
| `favicon.ico` | 48×48 | 3,542 | Legacy favicon (16, 32 and 48 px inside) |
| `favicon-16x16.png` | 16×16 | 445 | 16px favicon |
| `favicon-32x32.png` | 32×32 | 1,106 | 32px favicon |
| `apple-touch-icon.png` | 180×180 | 11,219 | iOS home screen icon |
| `android-chrome-192x192.png` | 192×192 | 11,549 | PWA icon 192px (purpose any) |
| `android-chrome-512x512.png` | 512×512 | 37,928 | PWA icon 512px (purpose any) |
| `maskable-icon-512x512.png` | 512×512 | 30,504 | PWA maskable icon (safe zone respected) |
| `og-image.png` | 1200×630 | 49,654 | Open Graph / Twitter card image |
| `site.webmanifest` | - | 654 | PWA web app manifest |
| `head-snippet.html` | - | 943 | Tags to paste inside <head> |
| `nextjs-metadata.ts` | - | 938 | Next.js App Router metadata export |

The run's dataset item, shortened:

```json
{
  "appName": "Acme Notes",
  "zipUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/launch-asset-pack.zip?signature=...",
  "zipBytes": 143005,
  "files": [
    {
      "name": "favicon.ico",
      "mime": "image/x-icon",
      "bytes": 3542,
      "sha256": "95e5c16db229dd16da8160f5173d044ca7b03678276cce74b8428ce8d6247563",
      "purpose": "Legacy favicon (16, 32 and 48 px inside)",
      "width": 48,
      "height": 48
    },
    {
      "name": "favicon-16x16.png",
      "mime": "image/png",
      "bytes": 445,
      "sha256": "e8d87f0b1624171ab7ac6732945799c847946dbaa7cc11903a079960b09be781",
      "purpose": "16px favicon",
      "width": 16,
      "height": 16
    },
    "... 9 more files"
  ],
  "manifest": {
    "name": "Acme Notes",
    "short_name": "Acme Notes",
    "start_url": "/",
    "scope": "/",
    "display": "standalone",
    "background_color": "#ffffff",
    "theme_color": "#0f766e",
    "icons": [
      {
        "src": "/android-chrome-192x192.png",
        "sizes": "192x192",
        "type": "image/png",
        "purpose": "any"
      },
      {
        "src": "/android-chrome-512x512.png",
        "sizes": "512x512",
        "type": "image/png",
        "purpose": "any"
      },
      {
        "src": "/maskable-icon-512x512.png",
        "sizes": "512x512",
        "type": "image/png",
        "purpose": "maskable"
      }
    ],
    "description": "Fast notes that sync everywhere."
  },
  "snippets": {
    "html": "<link rel=\"icon\" href=\"/favicon.ico\" sizes=\"48x48\">\n<link rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicon-32x32.png\">\n<link rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicon-16x16.png\">\n<link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"/apple-touch-icon.png\">\n<link rel=\"manifest\" href=\"/site.webmanifest\">\n<meta name=\"theme-color\" content=\"#0f766e\">\n<meta property=\"og:title\" content=\"Acme Notes\">\n<meta property=\"og:description\" content=\"Fast notes that sync everywhere.\">\n<meta property=\"og:url\" content=\"https://acme.app\">\n<meta property=\"og:type\" content=\"website\">\n<meta property=\"og:image\" content=\"https://acme.app/og-image.png\">\n<meta property=\"og:image:width\" content=\"1200\">\n<meta property=\"og:image:height\" content=\"630\">\n<meta property=\"og:image:alt\" content=\"Acme Notes logo and title\">\n<meta name=\"twitter:card\" content=\"summary_large_image\">\n<meta name=\"twitter:image\" content=\"https://acme.app/og-image.png\">",
    "nextjsAppRouter": "// app/layout.tsx ... (full file in the ZIP)",
    "viteIndexHtml": "<!-- index.html ... -->"
  },
  "source": {
    "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
    "format": "SVG",
    "width": 1024,
    "height": 1024,
    "hasTransparency": true
  },
  "warnings": [
    "Logo is not square (1012x990); it was centered on a transparent square."
  ]
}
```

The ZIP has two folders:

- **`public/`**: copy it to your web root. In Next.js and Vite that is the `/public` folder.
- **`snippets/`**: the `<head>` tags and `nextjs-metadata.ts`.

### Price and limits

- **$0.02 per asset pack**, charged only when the pack is built. Bad URLs, unsupported files and invalid colors fail without a charge.
- Logo formats: PNG, JPEG, WebP, GIF (first frame) or SVG. Maximum 10 MB and 16 megapixels.
- One pack per run. To make packs for several apps, call the Actor once per logo.

### Input

| Field | Required | Default | Notes |
|---|---|---|---|
| `logoUrl` | yes | | Public URL or file upload. A square, transparent logo of 512 px or more, or an SVG, gives the best result |
| `appName` | yes | | Used in the manifest, the snippets and the OG image |
| `shortName` | | app name | Text under the home-screen icon. 12 characters or fewer is recommended |
| `description` | | | Used in the manifest and `og:description`, and as the default OG tagline |
| `themeColor` | | `#111827` | `theme-color` and the default OG background |
| `backgroundColor` | | `#ffffff` | Background of the Apple touch icon, the maskable icon and the PWA splash screen |
| `ogTitle` / `ogTagline` / `ogBackgroundColor` | | | OG image text and color. Text color is chosen automatically for contrast |
| `siteUrl` | | | Makes `og:image` an absolute URL, which Facebook, LinkedIn and X require |
| `basePath` | | `/` | Use this if the files are not served from the site root |
| `trimTransparentEdges` | | `true` | Crops empty transparent margins around the logo |
| `iconPadding` | | `0` | Extra margin on favicons and PWA icons, from 0 to 0.3 |

### How the files are made

- **Apple touch icon:** placed on `backgroundColor` with a margin, because iOS shows transparent pixels as black.
- **Maskable icon:** keeps the logo inside the 80% safe zone, so Android launchers can crop it to a circle or squircle.
- **OG image text:** long titles shrink to fit in up to 3 lines and end with an ellipsis rather than being cut off. If the logo would disappear against the background, it is placed on a contrasting plate.
- **Warnings:** the `warnings` list flags anything that needs a human look, such as a low-resolution logo, a non-square logo, a logo without transparency, shortened text or non-Latin text the bundled font may not render.

### Call it from code, n8n or an AI agent

**API (synchronous, returns the dataset item):**

```bash
curl -X POST "https://api.apify.com/v2/acts/ferrolark~launch-asset-pack/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"logoUrl": "https://example.com/logo.svg", "appName": "Acme Notes", "siteUrl": "https://acme.app"}'
```

Then download `zipUrl`, unzip it and copy `public/` into your project.

**n8n:**

1. Add an **HTTP Request** node with method `POST` and the URL above (the token goes in the query string or in an `Authorization: Bearer` header).
2. Set the body to JSON with `logoUrl` and `appName`.
3. Add a second HTTP Request node that downloads `{{$json.zipUrl}}` as a file.

To import a ready-made workflow, copy this JSON into n8n with Ctrl+V on the canvas. Add a Header Auth credential with the name `Authorization` and the value `Bearer <your Apify token>`.

```json
{
  "name": "Ferrolark Launch Asset Pack",
  "nodes": [
    {
      "parameters": {},
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.apify.com/v2/acts/ferrolark~launch-asset-pack/run-sync-get-dataset-items",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\"logoUrl\": \"https://example.com/logo.svg\", \"appName\": \"Acme Notes\", \"siteUrl\": \"https://acme.app\"}",
        "options": {
          "timeout": 120000
        }
      },
      "name": "Build asset pack",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        220,
        0
      ],
      "notes": "Header Auth credential: name Authorization, value Bearer <your Apify token>"
    },
    {
      "parameters": {
        "url": "={{ $json.zipUrl }}",
        "options": {
          "response": {
            "response": {
              "responseFormat": "file"
            }
          }
        }
      },
      "name": "Download ZIP",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        440,
        0
      ]
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Build asset pack",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Build asset pack": {
      "main": [
        [
          {
            "node": "Download ZIP",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}
```

**AI agents (Cursor, Claude, ChatGPT and others) through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp):** add `ferrolark/launch-asset-pack` as a tool and ask "make the favicon and OG image for my app from logo.svg". The agent gets the files and the exact snippets to paste.

### Troubleshooting

| Problem | Fix |
|---|---|
| `Refusing to fetch a private or local address` | The logo URL must be publicly reachable. Upload the file instead |
| `Unsupported image format` | Convert the logo to PNG or SVG |
| The favicon looks blurry | Use a 512 px+ PNG or an SVG, and check the `warnings` list |
| The OG image doesn't update on social networks | Networks cache OG images. Change the filename or use their debugger tools to re-scrape |
| The SVG renders without its text | Text inside an SVG needs fonts that may not be installed. Convert text to paths before uploading |

### Limitations

- The OG image uses one built-in layout and font (Aileron). It is meant to look clean, not to replace a designer.
- Animated GIFs use only the first frame.
- Only upload logos you have the right to use.

### Changelog

- **1.0** (November 2026): first release with favicons, PWA icons, maskable icon, OG image, manifest, HTML and Next.js snippets, and a reproducible ZIP.

### More Ferrolark tools

- [Brand Name Availability Checker](https://apify.com/ferrolark/brand-name-checker): domains, GitHub, npm, PyPI and more in one report.
- [Domain Intelligence Report](https://apify.com/ferrolark/domain-intelligence-report): WHOIS, DNS, email security, SSL and hosting for any domain.
- [Live Deploy QA](https://apify.com/ferrolark/live-deploy-qa): meta tags, canonical, robots, OG image and favicon of your deployed routes, with diffs between deploys.
- [Sitemap Delta](https://apify.com/ferrolark/sitemap-delta): new, removed and broken URLs in any sitemap since the last run.
- [RSS Delta](https://apify.com/ferrolark/rss-delta): only new RSS, Atom and JSON Feed items, de-duplicated.
- [PDF Merge API](https://apify.com/ferrolark/pdf-merge-api): merge PDFs from URLs or base64 with page ranges and a SHA-256 manifest.
- [PDF Split API](https://apify.com/ferrolark/pdf-split-api): split a PDF by page ranges or every N pages, or extract pages, with a ZIP and manifest.
- [Image Convert](https://apify.com/ferrolark/image-convert): PNG, JPG, WebP, AVIF and HEIC conversion (SVG input too) from URLs or base64.
- [Image Compress & Resize](https://apify.com/ferrolark/image-compress-resize): resize images and compress them to a target size in KB, WebP or AVIF.
- [PDF to Image](https://apify.com/ferrolark/pdf-to-image): PDF pages to PNG, JPG or WebP at the DPI you choose.
- [Image to PDF](https://apify.com/ferrolark/image-to-pdf): JPG, PNG, HEIC and WebP images to one PDF, JPEGs embedded without recompression.
- [PDF Compress](https://apify.com/ferrolark/pdf-compress): smaller PDFs, lossless or with image downsampling; charged only when smaller.
- [HTML to PDF & URL to PDF](https://apify.com/ferrolark/html-to-pdf): web pages or raw HTML to PDF with headless Chrome.
- [Markdown to PDF](https://apify.com/ferrolark/markdown-to-pdf): Markdown with tables, code and footnotes to a clean PDF.
- [DOCX to PDF](https://apify.com/ferrolark/docx-to-pdf): Word, Excel, PowerPoint and ODT to PDF with LibreOffice.
- [Data Convert](https://apify.com/ferrolark/data-convert): CSV, JSON, NDJSON and Excel XLSX in any direction.

***

*Built by Ferrolark.*

# Actor input Schema

## `logoUrl` (type: `string`):

Public URL of your logo (PNG, JPEG, WebP, GIF or SVG; max 10 MB and 16 megapixels), or upload a file. A square logo with a transparent background of 512 px or larger (or SVG) gives the best result.

## `appName` (type: `string`):

Full name used in the web manifest, the page title snippet and the OG image.

## `shortName` (type: `string`):

Name under the home-screen icon (12 characters or fewer recommended). Defaults to the app name.

## `description` (type: `string`):

One sentence for the manifest and og:description. Also used as the OG tagline unless you set one.

## `themeColor` (type: `string`):

Hex color for the browser UI (theme-color) and, by default, the OG image background.

## `backgroundColor` (type: `string`):

Hex color behind the logo on the Apple touch icon, the maskable PWA icon and the splash screen.

## `ogTitle` (type: `string`):

Large text on the 1200x630 OG image. Defaults to the app name. Long titles shrink to fit and are never cut mid-word without an ellipsis.

## `ogTagline` (type: `string`):

Smaller text under the title. Defaults to the description. Set to an empty string for none.

## `ogBackgroundColor` (type: `string`):

Hex color for the OG image background. Defaults to the theme color. Text color is chosen automatically for contrast.

## `siteUrl` (type: `string`):

Your production URL, e.g. https://acme.app. Makes og:image absolute, which social networks require.

## `basePath` (type: `string`):

Path where the files will be served, if not the site root (e.g. /static/).

## `trimTransparentEdges` (type: `boolean`):

Crop empty transparent margins around the logo before sizing.

## `iconPadding` (type: `number`):

Extra margin on each side of favicons and PWA icons, as a fraction of the size (0 to 0.3).

## Actor input object example

```json
{
  "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
  "appName": "Acme Notes",
  "description": "Fast notes that sync everywhere.",
  "themeColor": "#111827",
  "backgroundColor": "#ffffff",
  "basePath": "/",
  "trimTransparentEdges": true,
  "iconPadding": 0
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `zip` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
    "appName": "Acme Notes",
    "description": "Fast notes that sync everywhere."
};

// Run the Actor and wait for it to finish
const run = await client.actor("ferrolark/launch-asset-pack").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
    "appName": "Acme Notes",
    "description": "Fast notes that sync everywhere.",
}

# Run the Actor and wait for it to finish
run = client.actor("ferrolark/launch-asset-pack").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "logoUrl": "https://upload.wikimedia.org/wikipedia/commons/8/84/Example.svg",
  "appName": "Acme Notes",
  "description": "Fast notes that sync everywhere."
}' |
apify call ferrolark/launch-asset-pack --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ferrolark/launch-asset-pack"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ydOz1fUxM0JLzboif/builds/FIySUUbh3rzwgirQD/openapi.json
