Raw schema
{
"type": "object",
"properties": {
"svg": {
"description": "Raw SVG markup to use as the icon. The best source when available.",
"type": "string"
},
"emoji": {
"description": "A single emoji character, rendered with Twemoji vector artwork.",
"type": "string"
},
"text": {
"description": "1–4 characters rendered as vector glyphs (e.g. a brand initial like \"F\").",
"type": "string"
},
"font": {
"description": "Typeface for text mode: any Google Fonts family name (e.g. \"Bangers\", \"Bebas Neue\", \"Press Start 2P\"), or a bundled id like inter-800, geist-700, silkscreen-400.",
"type": "string"
},
"text_color": {
"description": "Hex glyph color for text mode, default #0a0a0b.",
"type": "string"
},
"background": {
"description": "Icon background: \"none\" (default), a hex color, or a linear gradient.",
"anyOf": [
{
"type": "string",
"description": "\"none\" or a solid hex color"
},
{
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"angle": {
"type": "number"
}
},
"required": [
"from",
"to"
]
}
]
},
"padding": {
"description": "Content inset as a fraction of icon size, -1–0.35. Negative zooms in: the mark scales past the frame and is cropped toward the center (-0.5 renders it at 2x).",
"type": "number",
"minimum": -1,
"maximum": 0.35
},
"radius": {
"description": "Corner rounding: 0 square, ~0.25 rounded, 1 circle.",
"type": "number",
"minimum": 0,
"maximum": 1
},
"offset_x": {
"description": "Nudge content horizontally, -0.25 (left) to 0.25 (right).",
"type": "number",
"minimum": -0.25,
"maximum": 0.25
},
"offset_y": {
"description": "Nudge content vertically, -0.25 (up) to 0.25 (down).",
"type": "number",
"minimum": -0.25,
"maximum": 0.25
},
"app_name": {
"description": "App name written into the web manifest.",
"type": "string"
},
"short_name": {
"type": "string"
},
"theme_color": {
"description": "Hex theme color for the manifest.",
"type": "string"
},
"pwa": {
"description": "Include PWA icons + manifest (default true).",
"type": "boolean"
},
"google_96": {
"description": "Emit favicon-96x96.png for Google Search results (default true).",
"type": "boolean"
},
"dark_background": {
"description": "Hex background for a dark-mode variant; icon.svg then adapts to the browser theme.",
"type": "string"
},
"dark_text_color": {
"description": "Hex glyph color for the dark-mode variant (text mode).",
"type": "string"
},
"env_variants": {
"description": "Also emit dev/staging/preview favicon copies with a corner badge.",
"type": "boolean"
},
"monochrome": {
"description": "Add a monochrome manifest icon for tinted/badge surfaces.",
"type": "boolean"
},
"dynamic_module": {
"description": "Add favicon-dynamic.js — badge/progress/spinner with the icon baked in.",
"type": "boolean"
},
"framework": {
"description": "Tailors the setup guide: html, nextjs, vite, astro, rails, wordpress. Next.js App Router uses file conventions, not link tags.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}