# Navigating the Interface

Weavestream uses a multi-pane layout that should feel familiar if you've used an email client or RSS reader. Here's a tour of the main areas.

# The Sidebar

The sidebar on the left is your primary navigation. It has two tabs at the top:

  • Data — Browse your sources, endpoints, filters, and RSS feeds
  • Workflows — Access your workflow automations

# Data Tab

The Data tab is organized into sections:

  • All Items — Shows every item from every source. The badge shows your unread count.
  • Global Filters — Smart Filters that span across multiple sources appear here.
  • API Sources — Each source is an expandable section. Click the disclosure arrow to see its endpoints and source-specific filters. Hover over a source to reveal the ... menu with options like Add Endpoint, Sync Now, Edit, and Delete.
  • RSS Feeds — RSS categories work similarly to API sources. Expand a category to see individual feeds.

At the bottom of the sidebar, the + button lets you add new API sources, RSS categories, or global filters.

# Workflows Tab

Switch to the Workflows tab to see all your saved workflows. Click one to open it in the workflow editor.

# The Item List

The middle pane shows items from whatever you've selected in the sidebar — a specific endpoint, a source (all its endpoints combined), a Smart Filter, or All Items.

# Toolbar Controls

Above the item list, you'll find:

  • Sync All — Refreshes data from all your sources.
  • Filter — Filter items by status (Critical, Warning, Info, OK) and toggle whether archived items are visible.
  • Sort — Sort by Newest, Oldest, or Title.

# Item Rows

Each item in the list shows:

  • A status badge (if the item has a mapped status)
  • The title
  • The date (right-aligned)
  • A brief summary (up to two lines)
  • Read/unread indicator — Unread items appear with a slightly different style

Click an item to select it and view its details in the right pane. Right-click for additional actions.

# Search

Use the search bar at the top of the item list to search across item titles, summaries, and raw JSON content.

# The Detail View

The right pane shows the full details of the selected item.

# Header

  • Status badge and title at the top
  • Copy JSON button to copy the raw data to your clipboard
  • Field count indicator if a Smart Filter is limiting which fields are shown

# Content

The detail view displays the item's data as a key-value table. Each field from the API response is shown with its name on the left and value on the right. Text is selectable for easy copying.

If the item has related data from a Smart Filter join, those fields appear in a separate section with an orange tint.

# The AI Chat

Below the detail view (or toggled via the chat bubble), you'll find the AI Analysis panel. This is a chat interface where you can ask questions about your data. See Getting Started with AI for details.

# Layout Options

Weavestream supports both two-column and three-column layouts:

  • Three-column (default) — Sidebar, item list, and detail view side by side
  • Two-column — Sidebar and a combined list/detail view

You can toggle the item list visibility using the Items button in the toolbar.

# Keyboard Shortcuts

Shortcut Action
Cmd+N Add a new API source
Cmd+Shift+N Add a new endpoint to the selected source
Cmd+R Sync all sources
Cmd+S Save (in workflow editor)
Cmd+Plus Increase font size
Cmd+Minus Decrease font size

# Next Steps

Now that you know your way around, explore these topics: