Project Icon
Give a project a custom icon shown in the project switcher and titlebar.
Setting a project icon
Drop an icon file into the project's .hob/ directory. hob shows it wherever the project is
identified — the titlebar project chip and the project switcher rail. Projects without
an icon fall back to colored initials.
your-project/
.hob/
icon.svgSupported files
hob looks for these filenames in .hob/:
| File | Used for |
|---|---|
icon.svg / icon.png | All modes |
icon-dark.svg / icon-dark.png | Dark mode |
icon-light.svg / icon-light.png | Light mode |
Resolution is two-tiered: hob first looks for the variant matching your active color scheme, then falls back to the base files — theme-tier first, then format. In dark mode the order is:
icon-dark.svg → icon-dark.png → icon.svg → icon.pngSo a theme-specific PNG (icon-dark.png) is chosen over the base icon.svg. Within a tier,
SVG wins (vectors stay crisp at small sizes). If no icon file exists, the rail shows colored
initials from the project name.
Size limit
A project icon must be 128 KB or smaller. An icon over the limit is ignored and the project falls back to colored initials.
Icons are inlined and cached so they render instantly, with no flicker — keeping them small is what makes that possible. SVGs are typically well under 10 KB; a 256×256 PNG is usually plenty.
Updating an icon
Edit or replace the file in .hob/ and hob picks up the change automatically — no restart
needed.