feat(web): add customizable project icons

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}

[saphid]

What Changed

Projects without a custom or discovered favicon get an emoji chosen from their displayed name. A 5.2 KB local token classifier handles recognizable names such as customer-api, developer-docs, and ios-client; unknown names use a stable hash across generic choices. Existing projects receive an automatic emoji as soon as they load in the new client.

Project Settings opens on Emoji for automatic projects, with Emoji first in the picker. Users can pick a curated emoji, paste any emoji, search the full Lucide set, choose from 18 icon colors, use a project image, or reset to automatic selection. Saved Lucide choices still reopen on Icons. The choice is stored in the project projection and sent through the existing orchestration contract, so it remains consistent across web and Electron sessions and connected clients. The full Lucide manifest is lazy-loaded only when the picker or a saved Lucide override needs it.

Why

Projects without an image currently collapse to the same gray folder icon, which makes project lists harder to scan. Automatic local selection improves every new and existing project without a model download or network call, while Project Settings gives users direct control when the suggested icon is not right.

There is no open upstream issue for this feature, and Ideas discussions are unavailable, so this PR carries the motivation.

Verification

• Focused contract tests: 50 passed.
• Focused server migration, decider, projection pipeline, and snapshot tests: 58 passed.
• Focused web icon model, picker dialog, picker helper, favicon, and pull request filter tests: 27 passed.
• Contract, server, web, and desktop typechecks passed. Existing Effect suggestions remain in server and desktop output.
• Targeted lint passed with two pre-existing default-prop warnings in PullRequestListFilters.tsx.
• Production web build passed. The Lucide manifest emitted as a separate lazy chunk; existing CSS optimizer and chunk-size warnings remain.
• Real-client pass: confirmed an automatic project opens the picker on the first Emoji tab, then switched to Icons and confirmed Lucide search and color choices remain available.
• Takeover regression pass: confirmed an unsaved Lucide query, color, and icon survive live project snapshot updates.

UI Changes

Before, projects without images all use the folder fallback:

After, the local classifier chooses an emoji from each project name:

The cropped picker opens on Emoji by default, with Emoji first:

Icons remain the second choice, with Lucide search and colors:

The picker draft before and after a live project snapshot:

Checklist

• This PR is focused on project icon selection
• I explained what changed and why
• I included cropped before, after, Lucide picker, and emoji picker screenshots
• This change has no animation or timing behavior

Implementation used GPT-5.6 Sol in T3 Code. Icon-set and tiny-model research used GPT-5.6 Luna.

---

Note

Medium Risk
Touches orchestration projections and a DB migration, and ProjectFavicon now requires projectName—a breaking prop change for any out-of-tree callers.

Overview
Adds persisted project icon overrides (Lucide icon + color, or emoji) end-to-end: contract/command/event schemas, nullable project_icon_json on projection_projects (migration 047), and projection/decider/snapshot wiring alongside existing faviconPath.

ProjectFavicon now takes projectName and optional projectIcon, rendering saved overrides before uploaded favicons, with name-based automatic emoji (and Lucide fallbacks) when no image is available. Project settings gains ProjectIconPickerDialog (emoji first, searchable Lucide + colors) plus Choose file; picking an icon clears the favicon path and vice versa, with reset back to automatic.

The override is threaded through sidebar, chat header, command palette, PR filters, and related UI. User docs for project appearance are updated.

^{Reviewed by Cursor Bugbot for commit fc71edc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add customizable project icons with picker and automatic fallback

• Adds ProjectIconPickerDialog to select emojis or searchable Lucide icons with colors, integrated into ProjectSettingsPanel. Saving an icon clears the existing favicon, and vice versa.
• Introduces selectProjectIcon in projectIconModel.ts to provide deterministic automatic fallback icons based on project name keywords when no custom icon or favicon is present.
• Updates sidebar, command palette, chat header, pull request filters, and archived threads to render the saved override or the automatic fallback.
• Extends orchestration contracts and persistence layer with a nullable ProjectIconOverride, adding project_icon_json to projection_projects via migration 047.
• Behavioral Change: ProjectFavicon now prioritizes saved emoji or Lucide overrides over uploaded favicon assets, and otherwise selects a deterministic project-name/path fallback instead of a generic icon.

^{Macroscope summarized fc71edc.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This change introduces a new persisted project-icon customization workflow spanning settings, orchestration, database projections, and multiple UI surfaces. It also replaces the existing generic fallback with name-derived emoji defaults, changing product behavior for existing projects without explicit icons.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9eb703e. Configure here.}