doc(frontend): Unify sidebar project/org selector proposal

[ashrafchowdury]

Context

The main sidebar stacks two selectors, one for organization and one for project. Each one hides a submenu of management actions behind it: rename, delete, transfer ownership, set as default, copy ID. Those actions crowd a control that people open to switch context, and most of them already exist in Settings.

This PR adds the proposal doc. No code changes yet.

What the proposal says

The two selectors merge into one dropdown. That dropdown does three things: view, switch, create. Everything else moves to Settings, where eight of the twelve moved capabilities already live.

Before / after

Before	After

The dropdown

Projects	Organizations

What stays in the sidebar

Capability
View organizations
View projects
Switch project
Create project
Switch organization
Create organization
Logout

The bottom section keeps Settings, Help & Docs, and the announcement banner. Live chat support joins the Help & Docs submenu.

What moves, at a glance

Capability	Destination	Status
Rename org, transfer ownership, delete org	Settings, Organization, General	Already available
Rename project, set as default, delete project, default badge	Settings, Organization, Projects	Already available
Invite teammate	Settings, Organization, Members	Already available
Copy project ID	Settings, Organization, Projects	ID already shown, copy action to build
Copy organization ID	Settings, Organization, General	To build
Live chat support	Help & Docs submenu	Relocates

Eight capabilities already have a home in Settings. Three need building there. One is a submenu placement.

Full doc: docs/design/sidebar-selector-consolidation/proposal.md
Deisgn: https://claude.ai/code/artifact/35620381-537c-4969-b89e-e15bd67b86d7

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview	Aug 4, 2026 12:24pm

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Added a design proposal for consolidating organization and project selection into a single sidebar dropdown.
  • Retains switching, creation, settings, help, announcements, and logout options in the sidebar.
  • Moves management actions to Settings and live chat under Help & Docs.
  • Proposes organization ID copying, demo badges, and improved organization authentication handling.

Walkthrough

The proposal documents a unified organization and project sidebar selector. It defines relocated management, chat, and authentication actions, plus organization ID copying and demo-badge support in Settings.

Changes

Sidebar selector consolidation

Layer / File(s)	Summary
Unified sidebar selector design docs/design/sidebar-selector-consolidation/proposal.md	Documents the unified dropdown, retained sidebar actions, relocated Settings and Help & Docs capabilities, organization ID copying, demo-badge support, revised switching navigation, and app-level authentication error handling.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the proposal to unify the project and organization sidebar selectors.
Description check	✅ Passed	The description accurately explains the sidebar selector consolidation proposal and confirms that no code changes are included.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch code/sidebar-capabilities-table-d910bd

---

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.}

[coderabbitai]

Actionable comments posted: 2

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d3cfdb96-2d48-402a-b102-d37090dc4388

📥 Commits

Reviewing files that changed from the base of the PR and between 4165aa8 and f5a4d32.

📒 Files selected for processing (1)

• docs/design/sidebar-selector-consolidation/proposal.md

[mmabrouk]

Check this session and this whiteboard

[mmabrouk]

the main thing I think we should change in the interaction when clicking on switch organization (double click on the mockup in the whiteboard and you can use it)

[ashrafchowdury]

A side from the org selection, do you agree with other stuff, like the logo things that are hidden??

[mmabrouk]

yeah i think that's the only thing I would switch. The rest is good imo

[ashrafchowdury]

The purpose of this proposal pr is completed