primary-sidebar

Configure OrcaQ sidebar tabs by wiring ActivityBarItemType, store, and panel components.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/cin12211/orcaq-test --skill primary-sidebar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: primary-sidebar
Source: https://github.com/cin12211/orcaq-test/tree/main/.github/skills/primary-sidebar
Command: npx skills add https://github.com/cin12211/orcaq-test --skill primary-sidebar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps developers implement and manage the Primary Sidebar tabs in OrcaQ, enabling smooth navigation between Explorer, Schemas, ERD, and other management panels.

Core Features & Use Cases

  • Architecture overview and file locations for the primary sidebar switcher.
  • Step-by-step guidance to add, update, or remove tabs by wiring ActivityBarItemType, store, and panel components.
  • Real-world scenario: add a new management tab called "Agent" or customize an existing panel and ensure state is preserved with KeepAlive and persisted in the store.

Quick Start

Read the Primary Sidebar flow guide and follow the steps to add or modify a management panel by updating the ActivityBarItemType, creating a new management module, exporting it, and wiring it into PrimarySideBar.

Frequently Asked Questions about primary-sidebar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new management tab to the OrcaQ left sidebar?

To add a new management tab to the OrcaQ left sidebar, update the ActivityBarItemType enumeration, create a new management module, export it, and wire it into the PrimarySideBar switching logic.

How do I preserve Vue component state when switching primary sidebar panels?

To preserve Vue component state when switching primary sidebar panels, wrap your management modules with KeepAlive and persist the active panel state using the useActivityBarStore.

What is the architecture for extending the OrcaQ activity bar with Vue?

The OrcaQ activity bar architecture enforces modular design by separating the ActivityBarItemType enumeration, useActivityBarStore state, and individual panel components wired into the PrimarySideBar switcher.

Can I use custom hooks for sidebar panel logic in OrcaQ?

Yes, you can and are encouraged to use custom hooks for sidebar panel logic in OrcaQ. This practice enforces modular architecture and isolates management panel behavior from the PrimarySideBar switching logic.

What is the best way to remove an existing management panel from the primary sidebar?

The best way to remove an existing management panel from the primary sidebar is to delete the module, remove its corresponding ActivityBarItemType entry, and detach it from the PrimarySideBar wiring and useActivityBarStore.

Why does my OrcaQ sidebar lose its active tab state after navigation?

Your OrcaQ sidebar loses its active tab state because the panel component is not wrapped in KeepAlive or the active tab identifier is not properly persisted within the useActivityBarStore state.