Cursor favicon install runbook
Cursor edits a real repo on your machine, which makes favicons easy in one way and awkward in another. File placement is entirely under your control, but the model cannot draw a PNG — so generate the binaries first and let Cursor do the part it is genuinely good at: wiring the head, the manifest, and the commit.
The agent cannot author binaries
Ask Cursor to "create favicon.ico" and you get a text placeholder or an inline SVG. Bring real exported files; give the agent the markup job.
It already knows your framework
Cursor has the whole repo in context, so it can tell whether app/icon.png is picked up automatically or whether you need explicit tags in index.html.
URL finder for Cursor
Paste your Cursor preview link or production domain. We'll grab every favicon, let you choose one, and push it back to the generator.
Paste a domain and tap Scan to see every icon we can harvest.
We will open the generator with your selected favicon pre-loaded as the base image.
Playbook
Follow these beats whenever your builder regenerates UI so favicon coverage stays ahead of AI edits.
1Export the set into the repo
Generate the full kit and unzip it into your static directory — /public for Vite, Remix, and the Next pages router; the app directory for App Router icon conventions.
2Prompt with exact filenames
List the files you added and ask Cursor to reference them following the convention already used in this repo, rather than inventing a new one.
3Read the diff before accepting
The usual failure is a link tag pointing at a filename that was never created. Check every referenced path exists, then commit from the source control panel.
Checklist
Drop this straight into your deployment doc.
Add a project rule under .cursor/rules noting that icons are generated assets and must not be recreated by the agent.
Search the repo for "favicon" afterwards to catch leftover links from the original starter template.
Confirm the image files are actually staged — a broad ignore rule on binaries will silently leave them out of the commit.
Cursor favicon FAQ
Can Cursor generate a favicon for me?
Cursor can write every line of markup a favicon needs, but it cannot produce the image bytes, because the model outputs text. Generate the PNG and ICO files with a real tool, drop them in the repo, and use Cursor for the wiring and the commit.
Where should favicon files live in my repo?
It depends on the framework, and Cursor can tell you by looking. Next.js App Router projects pick up app/icon.png and app/apple-icon.png automatically, while Vite, Remix, and static sites want the files in /public plus explicit link tags in the HTML head.
Why does the tab still show the old icon after Cursor's edit?
Browsers cache favicons far more aggressively than other assets, and dev servers often serve a stale copy until restarted. Restart the dev server and load the page in a private window before assuming the change failed.
Cursor install guide
Add /cursor/favicon-install to project README files, onboarding docs, and launch checklists so nobody skips the favicon step.