You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Brand icons (Simple Icons) in the project icon picker
#19244
I added the Git source repo as a project and wanted the Git logo as its sidebar icon. Lucide has git-branch, git-commit and friends, but not the Git logo itself. Lucide's brand icons are deprecated, and each deprecation notice points to Simple Icons, which does have Git. From there I looked at svgl and Iconify as alternatives. The rest of this post compares them and proposes a small way to add brand icons.
Problem
Many projects are about a specific tool or service: a Terraform repo, a Postgres migration tool, a Discord bot, a Raycast extension, a Neovim config. The project icon picker offers Lucide icons, emoji, and monograms. Lucide has no icon for any of these. It has 18 older brand icons, such as GitHub, GitLab, Slack and Figma, but all of them are deprecated and due for removal in Lucide v1.0 (lucide-icons/lucide#670). The deprecation notice itself recommends Simple Icons instead.
Automatic favicons don't fill the gap either. Backends, CLIs, database repos, and dotfiles usually have no favicon to find (see the follow-up on #2561). When you have many projects, picking a recognizable logo is the quickest way to tell them apart in the sidebar.
Proposal
Make picking a brand icon as easy as picking a Lucide icon, using Simple Icons.
One search box. Brand icons appear in the same search as Lucide icons, not in a separate tab. Typing "git" shows Lucide's git-branch and the Git logo together.
Aliases match. Simple Icons includes alternative names, so "postgres" finds PostgreSQL and "k8s" finds Kubernetes.
Results as you type. The search list (titles, slugs and aliases) ships with the app. It is 31 KB gzipped, so searching never waits on the network.
Same look as Lucide icons. Brand icons use the existing ProjectIconColor palette, so they stay legible in light and dark themes. Brand hex colors can't do that, because several are near-black, such as GitHub's #181717.
No uploads or asset storage. The icon is a short value on the project, like a Lucide name or an emoji. This avoids the concern that closed #2561.
How the icons themselves reach the client is secondary. Either option below is fine:
Bundle the set. Store { kind: "simple-icon", slug: "git", color } and ship the icons as lazy per-icon chunks, the way Lucide icons load today. The download is about 2 MB gzipped. The icons rarely change between releases, so the desktop's blockmap-based differential updates keep update downloads small. Icons work offline.
Download the picked icon. Fetch the chosen icon from the Iconify API and store its path: { kind: "path", title: "Git", path: "M13.09 23.54…", color }. Nothing extra ships with the app. Mobile can draw the path with react-native-svg, and a saved icon survives Simple Icons later removing that brand. Picking needs a network connection.
Comparison of icon sets
60 common dev brands were checked against each set, including GitHub, AWS, Postgres, Vercel, Supabase, Next.js, Raycast, OpenAI, Anthropic, Godot and Home Assistant.
Simple Icons
svgl
Iconify logos
Devicon
Lucide (today)
Icons
3,466
670
2,227
1,069
1,917
Dev brands covered (of 60)
58 (no AWS, Azure)
58 (no Bitbucket, Arduino)
57 (no Raycast, Ollama, Home Assistant)
51
0
Style
One color, single path
Full color; 162 have light/dark variants
Full color
Full color
One color, stroked
Fits the color palette
Yes
No
No
No
Yes
License
CC0
MIT repo; logos belong to their brands
CC0
MIT
ISC
Avg icon, gzip
730 B
947 B
about 3.4 KB raw
about 4.8 KB raw
400 B
Whole set, gzip (bundled download)
1.96 MB
not packaged
2.82 MB
1.80 MB
0.16 MB
Runtime source
Iconify API, jsDelivr, cdn.simpleicons.org
api.svgl.app
Iconify API
Iconify API
n/a (bundled)
Maintenance
Very active, 26k★
Active, 6k★
Active, 7k★
Active, 12k★
Active
Simple Icons has the most brands, and it's the only brand set that is a single path in one color. That makes it the only one that can be stored as a plain path string, drawn safely without parsing arbitrary SVG, and tinted with the existing palette.
Full-color sets would need us to store and sanitize whole SVG documents and handle light and dark variants separately.
Delivery options
Bundle the set
Download the picked icon
Load from a CDN on every render
Download size
About +2 MB gzip for desktop and npx t3. Web loads only the icons it shows
+31 KB search list
+31 KB search list
Works offline
Yes
Displays offline; picking needs a network connection
No
Third-party requests
None
Only when picking
Every client, every render
Mobile
Monogram, unless mobile bundles the set too
Real icon
Real icon
Brand later removed upstream
Saved icon falls back to the default after a dependency bump
Unaffected
Saved icon breaks
Data sent to clients
Unchanged
Path sent with the project: median 776 B, p95 4.2 KB
Unchanged
Loading from a CDN on every render is listed for completeness. It's the weakest option.
Scope and cost
Area
Change
packages/contracts/src/project.ts
Add one member to ProjectIconOverride: a slug if the set is bundled, or a path if icons are downloaded. A path needs SVG path syntax validation (commands and numbers only) and a length cap. An 8 KB cap admits 98.7% of Simple Icons. ReceivedProjectIcon already decodes unknown kinds as "no override", so older clients show the default icon.
Server
Nothing beyond the schema. project.update already accepts ProjectIconOverride. (The t3_project_update MCP tool doesn't expose project icons at all today. That's a separate gap.)
Web picker (ProjectIconPickerDialog.tsx, projectIconOptions.ts)
Merge brand results into the existing icon search, matching on titles, slugs and aliases.
Web render (ProjectFavicon.tsx)
Render the icon tinted by color, falling back to the default icon if it can't be resolved. A path goes into an attribute, never into innerHTML.
Mobile
A monogram if the set is bundled, or the path drawn with react-native-svg if icons are downloaded.
Tests
Contract round-trip and forward-compatible decoding of the new kind, plus path validation if paths are stored.
Risks and tradeoffs
Bundle size, if the set is bundled. About 2 MB gzipped. The full simple-icons import must never reach the entry chunk, so the build output should be checked for that. The fix in #9943, which keeps icon chunks from loading eagerly in unbundled dev, should be checked as well.
Network and a third party, if icons are downloaded. Air-gapped installs can't pick brand icons. Picking depends on the Iconify API being up, but icons that are already saved don't.
Trademarks. The SVGs are CC0, but the logos are still trademarks. A user choosing a logo for their own project is the use Simple Icons is meant for. We wouldn't ship any logo as a default.
Mixed versions. A new client talking to an older server can't save the new kind, because the server would reject it. This is the same situation as any new icon kind.
Possible follow-up
Suggest icons based on the repo. A Cargo.toml suggests Rust, go.mod suggests Go, and a GitHub remote suggests GitHub. The Git repo would offer the Git logo before you type anything. This could reuse the code that already looks for project favicons.
Out of scope
Full-color logos (svgl, Iconify logos). These need SVG sanitization and light/dark handling.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
How I got here
I added the Git source repo as a project and wanted the Git logo as its sidebar icon. Lucide has
git-branch,git-commitand friends, but not the Git logo itself. Lucide's brand icons are deprecated, and each deprecation notice points to Simple Icons, which does have Git. From there I looked at svgl and Iconify as alternatives. The rest of this post compares them and proposes a small way to add brand icons.Problem
Many projects are about a specific tool or service: a Terraform repo, a Postgres migration tool, a Discord bot, a Raycast extension, a Neovim config. The project icon picker offers Lucide icons, emoji, and monograms. Lucide has no icon for any of these. It has 18 older brand icons, such as GitHub, GitLab, Slack and Figma, but all of them are deprecated and due for removal in Lucide v1.0 (lucide-icons/lucide#670). The deprecation notice itself recommends Simple Icons instead.
Automatic favicons don't fill the gap either. Backends, CLIs, database repos, and dotfiles usually have no favicon to find (see the follow-up on #2561). When you have many projects, picking a recognizable logo is the quickest way to tell them apart in the sidebar.
Proposal
Make picking a brand icon as easy as picking a Lucide icon, using Simple Icons.
git-branchand the Git logo together.ProjectIconColorpalette, so they stay legible in light and dark themes. Brand hex colors can't do that, because several are near-black, such as GitHub's#181717.How the icons themselves reach the client is secondary. Either option below is fine:
{ kind: "simple-icon", slug: "git", color }and ship the icons as lazy per-icon chunks, the way Lucide icons load today. The download is about 2 MB gzipped. The icons rarely change between releases, so the desktop's blockmap-based differential updates keep update downloads small. Icons work offline.{ kind: "path", title: "Git", path: "M13.09 23.54…", color }. Nothing extra ships with the app. Mobile can draw the path withreact-native-svg, and a saved icon survives Simple Icons later removing that brand. Picking needs a network connection.Comparison of icon sets
60 common dev brands were checked against each set, including GitHub, AWS, Postgres, Vercel, Supabase, Next.js, Raycast, OpenAI, Anthropic, Godot and Home Assistant.
logoscdn.simpleicons.orgapi.svgl.appSimple Icons has the most brands, and it's the only brand set that is a single path in one color. That makes it the only one that can be stored as a plain path string, drawn safely without parsing arbitrary SVG, and tinted with the existing palette.
Full-color sets would need us to store and sanitize whole SVG documents and handle light and dark variants separately.
Delivery options
npx t3. Web loads only the icons it showsLoading from a CDN on every render is listed for completeness. It's the weakest option.
Scope and cost
packages/contracts/src/project.tsProjectIconOverride: a slug if the set is bundled, or a path if icons are downloaded. A path needs SVG path syntax validation (commands and numbers only) and a length cap. An 8 KB cap admits 98.7% of Simple Icons.ReceivedProjectIconalready decodes unknown kinds as "no override", so older clients show the default icon.project.updatealready acceptsProjectIconOverride. (Thet3_project_updateMCP tool doesn't expose project icons at all today. That's a separate gap.)ProjectIconPickerDialog.tsx,projectIconOptions.ts)ProjectFavicon.tsx)color, falling back to the default icon if it can't be resolved. A path goes into an attribute, never intoinnerHTML.react-native-svgif icons are downloaded.Risks and tradeoffs
simple-iconsimport must never reach the entry chunk, so the build output should be checked for that. The fix in #9943, which keeps icon chunks from loading eagerly in unbundled dev, should be checked as well.Possible follow-up
Suggest icons based on the repo. A
Cargo.tomlsuggests Rust,go.modsuggests Go, and a GitHub remote suggests GitHub. The Git repo would offer the Git logo before you type anything. This could reuse the code that already looks for project favicons.Out of scope
logos). These need SVG sanitization and light/dark handling.🤖 Generated with Claude Code
All reactions