Fetch Favicon

Internal Service — This is not an HTTP endpoint. It’s called directly by the generate-all orchestrator.

Purpose

Downloads the favicon from a website, converts it to PNG format, and uploads it to Supabase Storage. Returns a public URL for the favicon. Runs in GROUP 1e (parallel with scrape, fire-and-forget). Doesn’t need scraped pages.

Function Signature

async def run_favicon(url: str, org_slug: str) -> StepResult

Parameters

Parameter	Type	Description
`url`	`str`	The website URL
`org_slug`	`str`	The Clerk organization slug

Returns

{
  "name": "favicon",
  "status": "success",
  "data": {
    "favicon_url": "https://supabase.co/storage/v1/object/public/favicons/my-business/favicon.png"
  }
}

Favicon Discovery Order

The service tries these locations in order:

/favicon.ico - Standard location
/apple-touch-icon.png - iOS icon (usually higher quality)
/apple-touch-icon-precomposed.png - Alternative iOS icon
HTML <link rel="icon"> tag
HTML <link rel="shortcut icon"> tag
Fallback: Google’s favicon service (https://www.google.com/s2/favicons?domain=...)

Processing Pipeline

Storage Location

Favicons are stored in Supabase Storage:

bucket: favicons
path: {org_slug}/favicon.png

Public URL format:

https://{project}.supabase.co/storage/v1/object/public/favicons/{org_slug}/favicon.png

Code Location

src/app/apis/onboarding/generate_all/
├── favicon.py          # fetch_favicon function
└── tasks/
    └── favicon.py      # run_favicon task wrapper

Error Handling

{
  "name": "favicon",
  "status": "error",
  "error": "Could not find favicon at any standard location"
}

If favicon fetch fails, the onboarding continues without a favicon. The UI shows a default placeholder.

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

Purpose

Function Signature

Parameters

Returns

Favicon Discovery Order

Processing Pipeline

Storage Location

Code Location

Error Handling

​Purpose

​Function Signature

​Parameters

​Returns

​Favicon Discovery Order

​Processing Pipeline

​Storage Location

​Code Location

​Error Handling

Purpose

Function Signature

Parameters

Returns

Favicon Discovery Order

Processing Pipeline

Storage Location

Code Location

Error Handling