Skip to content

Commit 9666df0

Browse files
hongyi-chenoz-agent
hongyi-chen
and
oz-agent
committed
Collapse top-level sidebar groups by default
Currently every top-level group within a topic's sidebar (e.g. 'Getting started', 'Warp Agents', 'Third-Party CLI Agents', 'Oz Cloud Agents & Orchestration', etc.) renders fully expanded on first load. The result is a long sidebar where most items sit below the fold. Add 'collapsed: true' to all 26 top-level groups across the Terminal, Agents, Reference, Support & Community, Enterprise, and Guides topics. Starlight's SidebarSublist still auto-expands the ancestor of the current page (via the 'isCurrent' inside the group check), so deep links continue to highlight context — only siblings stay closed. Nested groups (e.g. 'Capabilities', 'Triggers', 'Integrations', 'GitHub Actions', 'Self-hosting', 'API Troubleshooting > Errors') are intentionally left untouched. Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 1e7482a commit 9666df0

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

‎src/sidebar.ts‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
2424
items: [
2525
{
2626
label: 'Getting started',
27+
collapsed: true,
2728
items: [
2829
{ label: 'Getting started with Warp and Oz', link: '/' },
2930
{ slug: 'quickstart', label: 'Warp quickstart' },
@@ -49,6 +50,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
4950
},
5051
{
5152
label: 'Terminal',
53+
collapsed: true,
5254
items: [
5355
'terminal/input/universal-input',
5456
'terminal/input/classic-input',
@@ -179,6 +181,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
179181
},
180182
{
181183
label: 'Code',
184+
collapsed: true,
182185
items: [
183186
{ slug: 'code/overview', label: 'Code overview' },
184187
{
@@ -198,6 +201,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
198201
},
199202
{
200203
label: 'Knowledge and collaboration',
204+
collapsed: true,
201205
items: [
202206
{
203207
label: 'Warp Drive overview',
@@ -226,6 +230,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
226230
items: [
227231
{
228232
label: 'Getting started',
233+
collapsed: true,
229234
items: [
230235
{ slug: 'agent-platform', label: 'Agents overview' },
231236
'agent-platform/getting-started/agents-in-warp',
@@ -234,6 +239,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
234239
},
235240
{
236241
label: 'Warp Agents',
242+
collapsed: true,
237243
items: [
238244
{ slug: 'agent-platform/local-agents/overview', label: 'Warp Agents overview' },
239245
{
@@ -285,6 +291,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
285291
},
286292
{
287293
label: 'Third-Party CLI Agents',
294+
collapsed: true,
288295
items: [
289296
{ slug: 'agent-platform/cli-agents/overview', label: 'Overview' },
290297
'agent-platform/cli-agents/claude-code',
@@ -296,6 +303,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
296303
},
297304
{
298305
label: 'Oz Cloud Agents & Orchestration',
306+
collapsed: true,
299307
items: [
300308
{ slug: 'agent-platform/cloud-agents/overview', label: 'Cloud agents overview' },
301309
{ slug: 'agent-platform/cloud-agents/quickstart', label: 'Quickstart' },
@@ -366,6 +374,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
366374
{ slug: 'reference', label: 'Technical reference' },
367375
{
368376
label: 'CLI',
377+
collapsed: true,
369378
items: [
370379
{ slug: 'reference/cli', label: 'Oz CLI' },
371380
{ slug: 'reference/cli/quickstart', label: 'Quickstart' },
@@ -380,6 +389,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
380389
},
381390
{
382391
label: 'API & SDK',
392+
collapsed: true,
383393
items: [
384394
{ slug: 'reference/api-and-sdk', label: 'Oz API & SDK' },
385395
{ slug: 'reference/api-and-sdk/quickstart', label: 'Quickstart' },
@@ -445,6 +455,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
445455
{ slug: 'support-and-community', label: 'Support and Community' },
446456
{
447457
label: 'Community',
458+
collapsed: true,
448459
items: [
449460
'support-and-community/community/contributing',
450461
'support-and-community/community/warp-preview-and-alpha-program',
@@ -454,6 +465,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
454465
},
455466
{
456467
label: 'Troubleshooting and support',
468+
collapsed: true,
457469
items: [
458470
{ slug: 'support-and-community/troubleshooting-and-support/sending-us-feedback', label: 'Sending Feedback & Logs' },
459471
'support-and-community/troubleshooting-and-support/known-issues',
@@ -465,6 +477,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
465477
},
466478
{
467479
label: 'Plans and billing',
480+
collapsed: true,
468481
items: [
469482
{ slug: 'support-and-community/plans-and-billing', label: 'Overview' },
470483
{ slug: 'support-and-community/plans-and-billing/plans-pricing-refunds', label: 'Plans, Pricing, & Refunds' },
@@ -477,6 +490,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
477490
},
478491
{
479492
label: 'Privacy, security, and licensing',
493+
collapsed: true,
480494
items: [
481495
'support-and-community/privacy-and-security/privacy',
482496
'support-and-community/privacy-and-security/secret-redaction',
@@ -493,6 +507,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
493507
items: [
494508
{
495509
label: 'Getting started',
510+
collapsed: true,
496511
items: [
497512
{ slug: 'enterprise', label: 'Overview' },
498513
{ slug: 'enterprise/getting-started/quickstart', label: 'Quick start' },
@@ -503,6 +518,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
503518
},
504519
{
505520
label: 'Security and compliance',
521+
collapsed: true,
506522
items: [
507523
{ slug: 'enterprise/security-and-compliance/security-overview', label: 'Security overview' },
508524
{ slug: 'enterprise/security-and-compliance/sso', label: 'Single Sign-On (SSO)' },
@@ -511,6 +527,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
511527
},
512528
{
513529
label: 'Team management',
530+
collapsed: true,
514531
items: [
515532
'enterprise/team-management/teams',
516533
{ slug: 'enterprise/team-management/admin-panel', label: 'Admin panel' },
@@ -519,13 +536,15 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
519536
},
520537
{
521538
label: 'Enterprise features',
539+
collapsed: true,
522540
items: [
523541
{ slug: 'enterprise/enterprise-features/architecture-and-deployment', label: 'Architecture and deployment' },
524542
{ slug: 'enterprise/enterprise-features/bring-your-own-llm', label: 'Bring your own LLM' },
525543
],
526544
},
527545
{
528546
label: 'Support and resources',
547+
collapsed: true,
529548
items: [
530549
'enterprise/support-and-resources/billing',
531550
{ slug: 'enterprise/support-and-resources/troubleshooting-login', label: 'Troubleshooting login' },
@@ -543,6 +562,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
543562
{ slug: 'guides', label: 'Guides' },
544563
{
545564
label: 'Getting started',
565+
collapsed: true,
546566
items: [
547567
'guides/getting-started/welcome-to-warp',
548568
{ slug: 'guides/getting-started/10-coding-features-you-should-know', label: '10 Warp Coding Features You Should Know' },
@@ -553,6 +573,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
553573
},
554574
{
555575
label: 'Agent workflows',
576+
collapsed: true,
556577
items: [
557578
{ slug: 'guides/agent-workflows/how-to-review-ai-generated-code', label: 'Review AI-Generated Code' },
558579
{ slug: 'guides/agent-workflows/how-to-run-multiple-ai-coding-agents', label: 'Run Multiple AI Coding Agents' },
@@ -569,6 +590,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
569590
},
570591
{
571592
label: 'Configuration',
593+
collapsed: true,
572594
items: [
573595
{ slug: 'guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind', label: 'Create Project Rules' },
574596
{ slug: 'guides/configuration/how-to-set-coding-best-practices', label: 'Set Coding Best Practices with Rules' },
@@ -584,6 +606,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
584606
},
585607
{
586608
label: 'External tools & integrations',
609+
collapsed: true,
587610
items: [
588611
{ slug: 'guides/external-tools/how-to-set-up-claude-code', label: 'Set Up Claude Code' },
589612
{ slug: 'guides/external-tools/how-to-set-up-codex-cli', label: 'Set Up Codex CLI' },
@@ -603,6 +626,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
603626
},
604627
{
605628
label: 'Build an app in Warp',
629+
collapsed: true,
606630
items: [
607631
{ slug: 'guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway', label: 'Build a Real-time Chat App' },
608632
{ slug: 'guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css', label: 'Build a Chrome Extension' },
@@ -612,6 +636,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
612636
},
613637
{
614638
label: 'DevOps & infrastructure',
639+
collapsed: true,
615640
items: [
616641
{ slug: 'guides/devops/how-to-analyze-cloud-run-logs-gcloud', label: 'Analyze Cloud Run Logs (gcloud)' },
617642
{ slug: 'guides/devops/how-to-create-a-production-ready-docker-setup', label: 'Create a Production-Ready Docker Setup' },
@@ -624,6 +649,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
624649
},
625650
{
626651
label: 'Frontend & UI',
652+
collapsed: true,
627653
items: [
628654
{ slug: 'guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase', label: 'Replace a UI Element (Rust Codebase)' },
629655
{ slug: 'guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind', label: 'Code UI That Matches Your Mockup (React + Tailwind)' },

0 commit comments

Comments
 (0)