feat(settings): self-host settings plane, Sim wordmark in sidebar

[TheodoreSpeaks]

Summary

• New /selfhost/settings/{general,billing,chat-keys} plane — the settings a self-hoster needs from the managed service, open to any signed-in user
• Chat keys move off the account plane entirely. They previously lived at a standalone /account/settings/chat-keys page that nothing in the app linked to, behind an isHosted gate
• Registry unified projection is now optional (mirroring planes), so a section can opt out of the editor sidebar instead of being forced into it
• Plane items resolve their own description and throw when one is missing — a plane-only section has no unified projection to inherit from
• Settings sidebar shows the Sim wordmark linking to /?home instead of a Back chip; drops the now-dead backHref prop
• bun run setup runs bun install first, so a fresh clone is one command

Type of Change

• New feature

Testing

Tested manually on localhost. type-check, lint:check, and all 11 CI audits (check:boundaries, check:api-validation:strict, check:utils, check:zustand-v5, check:react-query, check:client-boundary, check:bare-icons, check:icon-paths, check:realtime-prune, skills:check, agent-stream-docs:check) pass. 24 settings nav/shell tests pass.

Note: the self-host plane has no inbound link yet — the natural entry point is the setup wizard printing the URL once it connects a Chat key. Follow-up.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jul 27, 2026 11:49pm

[cursor]

PR Summary

Medium Risk
New auth-gated routes and navigation registry changes affect where users manage Chat API keys; misconfigured isHosted/billing gates could redirect or hide chat-keys incorrectly, but scope is mostly UI/routing with existing components.

Overview
Introduces a self-host settings plane at /selfhost/settings (general, billing, chat-keys) for signed-in users, with layout, routing, registry entries, and a renderer that reuses existing General/Billing/Copilot UI.

Chat keys move off the hidden /account/settings/chat-keys route onto the self-host plane (hosted-only); the account chat-keys page is removed. The copilot settings component is renamed/refactored for reuse in workspace and self-host shells (no account back link).

The settings registry gains an optional unified projection and a selfhost plane; plane-only sections must supply their own description. Sidebar chrome is plane-driven: self-host shows the Sim wordmark → /?home instead of Back; backHref is removed.

Docs and onboarding: README quickstart uses git clone + bun run setup (which now runs bun install first); Chat key management URL points to sim.ai/selfhost/settings/chat-keys. PostHog settings_tab_viewed includes selfhost.

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

[greptile-apps]

Greptile Summary

Adds a self-host settings plane and moves chat keys off the account plane.

• New /selfhost/settings/{general,billing,chat-keys} routes with session gate and plane-specific nav
• Optional registry unified projection; plane-only sections (chat-keys) supply their own descriptions
• Sidebar chrome uses Sim wordmark → /?home on self-host; account/org Back goes to /workspace
• README/bun run setup one-command clone path; PostHog plane type includes selfhost

Confidence Score: 5/5

This follow-up pass finds no remaining blocking issues relative to prior Greptile threads, so the PR appears safe to merge from that scope.

No prior inline Greptile findings remain outstanding in the available review context, and no eligible follow-up comments were established against previous threads.

Important Files Changed

Filename	Overview
apps/sim/components/settings/navigation.ts	Adds selfhost plane, optional unified projection, SELFHOST_SETTINGS_ITEMS, and description throw for plane-only sections.
apps/sim/components/settings/standalone-settings-shell.tsx	Wires selfhost sidebar filtering (billing/isHosted) and shared shell chrome via SETTINGS_PLANE_CHROME.
apps/sim/components/settings/selfhost-settings-renderer.tsx	Client renderer for general, billing, and chat-keys with settings_tab_viewed analytics.
apps/sim/app/selfhost/settings/[section]/page.tsx	Auth + section parse, billing/chat-keys feature redirects, Suspense around renderer.
apps/sim/components/settings/settings-sidebar.tsx	Replaces backHref with plane chrome; wordmark leave guard vs Back to workspace.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Signed-in user] --> B["/selfhost/settings"]
  B --> C[Redirect general]
  C --> D[StandaloneSettingsShell plane=selfhost]
  D --> E[Sidebar: general / billing / chat-keys]
  E --> F[SelfHostSettingsRenderer]
  F --> G[General]
  F --> H["Billing scope=account"]
  F --> I[Copilot / Chat keys]

Loading

_{Reviews (2): Last reviewed commit: "fix(settings): hide self-host Chat keys ..." | Re-trigger Greptile}

[TheodoreSpeaks]

@greptile

[TheodoreSpeaks]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 09a13b9. Configure here.}