feat(web): project icons can be chosen manually

[t3dotgg]

Projects currently rely on automatic icon detection with no way to correct the result. This adds an explicit project icon setting while keeping automatic detection as the default.

The new Appearance section shows the detected icon and path. Users can select a supported image from the project, or switch back to automatic detection. T3 Code stores the override with project metadata so web, desktop, mobile, and remote clients use the same icon.

Visual reference: Option C settings mock

Tests:

• vp test run apps/server/src/project/ProjectFaviconResolver.test.ts apps/server/src/assets/AssetAccess.test.ts apps/server/src/orchestration/decider.projectScripts.test.ts apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts apps/server/src/persistence/Migrations/039_ProjectionProjectFaviconPath.test.ts packages/client-runtime/src/state/assets.test.ts apps/web/src/components/ProjectFavicon.test.tsx
• Targeted lint for changed TypeScript files
• Type checks for contracts, client runtime, server, web, and mobile

Built by GPT-5.6 in T3 Code through the Codex harness.

---

Note

Medium Risk
Touches orchestration persistence, asset URL signing, and cross-client projection; mitigated by schema validation, server-authoritative paths, and broad tests.

Overview
Adds manual project icon selection while keeping automatic detection as the default. Users can pick a workspace image from project settings or reset to automatic; the choice syncs across web, mobile, and remote clients.

Persistence & pipeline: faviconPath flows through project.meta.update, events, projector, and SQLite (favicon_path via migration 040). Contracts validate paths as supported image extensions only.

Server resolution: ProjectFaviconResolver prefers the saved override when the file exists, then falls back to t3.json and well-known paths. Asset URL issuance loads the authoritative path from the project projection (client path on the resource is a cache hint only), returns optional sourcePath, and rejects non-image files.

UI: New Appearance section and ProjectFaviconPickerDialog use workspace search with an imageOnly filter. ProjectFavicon and thread/sidebar/header surfaces pass faviconPath through.

Docs link to Customize a project icon in project-settings.md.

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

Note

Add manual project icon selection in project settings

• Adds a ProjectFaviconPickerDialog that searches project files filtered to image types, letting users select a custom icon for a project from the settings panel.
• Persists the chosen faviconPath through the event/projection pipeline: new faviconPath field on OrchestrationProject, ProjectMetaUpdateCommand, and related payloads, backed by a new favicon_path column added via migration 040.
• ProjectFaviconResolver.resolvePath now checks the saved faviconPath first (when the file exists in the workspace) before falling back to t3.json and well-known icon candidates.
• AssetAccess.issueAssetUrl accepts an explicit projectFaviconPath override, validates resolved paths against allowed image extensions, and returns a sourcePath in the result.
• The faviconPath is threaded through all UI surfaces that render project icons: sidebar rows, thread list headers, chat header, command palette, archived threads, and mobile screens.

^{Macroscope summarized ae1e94e.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 2fd5521a-8bb6-45f9-95d9-389f19ed9fd5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	11.3 KiB	11.3 KiB	+6 B (+0.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	5.5 KiB	5.5 KiB	0 B (0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	5.9 KiB	5.9 KiB	+6 B (+0.1%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	49.7 KiB	49.7 KiB	0 B (0.0%)	66.4 KiB	✅
Codex	Live turn messages	16	16	0 (0.0%)	21	✅
Claude	Total thread wire	11.3 KiB	11.3 KiB	−4 B (−0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	5.5 KiB	5.5 KiB	−7 B (−0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	5.9 KiB	5.9 KiB	+3 B (+0.1%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	50.6 KiB	50.6 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	16	16	0 (0.0%)	21	✅

Baseline: 05eb051 · PR result: ae1e94e · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 94.6 KiB
• Claude decoded thread snapshot: 95.4 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Needs human review

New feature adding manual project icon selection, including a database migration, new UI dialog/workflow, orchestration event changes, and asset resolution modifications. The scope and schema impact warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

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

^{Reviewed by Cursor Bugbot for commit 3b7d26e. Configure here.}