Navigation & Search

3.1 Sidebar Layout

The left sidebar provides navigation through your scripts and collections of the application.

Sidebar Structure (Top to Bottom)

  1. Organization Switcher (top): Switch between workspaces
  2. New Script Button: Full-width primary action
  3. Search Bar: Quick access to search (also Cmd+K)
  4. Navigation Content:
    • Recent & Starred filters
    • My Space section (My Scripts, My Collections)
    • Shared in [Org] section (Team Scripts, Team Collections) - org workspaces only
  5. User Profile (bottom): User menu and settings

Resizing the Sidebar

  1. Hover over the right edge of the sidebar until you see a resize cursor
  2. Click and drag to resize the sidebar width
  3. Width range: 200px to 600px
  4. Your preferred width is saved automatically

Collapsing the Sidebar

The sidebar supports an icon-only mode for minimal footprint:

  1. Snap to collapse: Drag the sidebar width below ~120px to collapse it to icon-only mode (56px)
  2. Snap to expand: When collapsed, drag past ~120px to expand back to full width
  3. Toggle button: Use the collapse/expand button at the bottom of the sidebar
  4. Your collapsed preference is saved automatically

Collapsed Mode Features

When the sidebar is collapsed to icon-only mode:

  • Scripts and collections icons remain visible
  • Hover over icons to see tooltips
  • Click any icon to navigate
  • User menu and settings remain accessible

Edge Cases:

  • Sidebar width persists across sessions
  • Collapsed state persists until manually changed
  • Mobile devices always show the hamburger menu (sidebar is not available)

3.2 Quick Search Dialog (Cmd+K / Ctrl+K)

Quickly search across all scripts and collections with a keyboard shortcut.

Opening Quick Search

  • Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) anywhere in the app
  • Or click the search icon in the navigation

Using Quick Search

  1. Type to search across script titles and collection names
  2. Results update in real-time as you type
  3. Use ↑ and ↓ arrow keys to navigate results
  4. Press Enter to open the selected item
  5. Press Escape to close the dialog

Quick Search Features

  • Recent scripts: When opened, shows recently accessed scripts
  • Script results: Shows matching scripts with preview
  • Collection results: Shows matching collections with item count
  • Create new: Click "Create Script" to start a new script

Edge Cases:

  • Search is case-insensitive
  • Search matches titles; content search may be limited for performance
  • Results are limited to items you have access to
  • Quick search uses cached data for fast results

3.3 Inline Mobile Search

On mobile devices, search is integrated directly into the navigation menu.

Using Mobile Search

  1. Tap the hamburger menu (☰) to open navigation
  2. Type in the search input at the top
  3. Results appear as a dropdown below the search field
  4. Use arrow keys (on external keyboard) or tap to navigate results
  5. Tap a result to navigate and close the menu

Edge Cases:

  • Mobile search uses the same filtering logic as the Quick Search dialog
  • Search results are limited to scripts and collections you have access to
  • Menu closes automatically when you select a result