Navigation
Goal: Find your way around the workshop.
The workshop is organized around workshops, surfaces, and nodes. Knowing the hierarchy makes everything easier to find.
The hierarchy
Organization
└── Workshop (your main environment)
├── Connections (data sources)
└── Surfaces (scoped workspaces)
└── Nodes
└── Warm Queries
The main areas
| Area | Where | For |
|---|---|---|
| Workshop selector | Top-left breadcrumb | Switch workshops |
| Node Bank | Left edge | Drag nodes onto the canvas |
| Canvas | Center | Your connections, surfaces, and queries |
| Inspector | Right panel | View and edit details |
| Azi panel | Left | Ask for what you want |
| Top bar | Top | APIs, proposals, deploy |
The top bar
| Item | What it does |
|---|---|
| APIs | API keys, the data API, the warm query manager |
| Proposals | Review pending proposals |
| Deploy | Push committed changes live |
Working with surfaces
- Surfaces appear as nodes on the canvas
- Click a surface to select it and open the Inspector
- Click the Manage Surface icon to enter it
- Inside, you see its connected nodes and warm queries
- Use the breadcrumb to step back out
The Inspector
Select any item and the Inspector shows:
| Section | Content |
|---|---|
| Overview | Name, type, status |
| Properties | Configuration |
| Data | Live or sample data |
| Queries | Associated warm queries |
| History | Recent changes |
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Ctrl+S | Save |
Ctrl+K | Open the command palette |
Escape | Close a panel or dialog |
/ | Focus the Azi chat |
Finding things
Press Ctrl+K (or click search), type what you're after - surfaces, nodes, queries - and click a result
to jump to it. Or just ask Azi: "Show me the signups query" or "Open the ProductData connection."
Breadcrumbs
The breadcrumb at the top shows your location:
Workshop > Surface > Node > Warm Query
Click any level to jump there. Between breadcrumbs, search, and Azi, you're never lost.
Next steps
- Save and ship changes -> Save vs Commit
- Create a surface -> Surfaces