6 min read

Speed Run Tour Documentation

Overview

The Speed Run is Vantage's interactive onboarding tour that walks new users through every major feature of the platform. Built on top of driver.js, the tour uses step-by-step popover highlights to introduce the navigation sidebar, dashboards, the dashboard editor, the AI assistant, the workflow builder, integrations, notifications, the command palette, and all settings sections. The Speed Run is automatically triggered on a user's first login and can be restarted from the home page at any time.

Purpose

The Speed Run eliminates the learning curve for new users by providing a guided, interactive walkthrough of the entire platform. Instead of reading static documentation, users see each feature highlighted in context with clear descriptions and natural progression between sections.

How It Works

Trigger

The Speed Run is triggered in two ways:

First Login — Automatically starts when a user logs in for the first time.
Manual Start — Click the "Start Speed Run" button on the home page's News Board section.

Stage System

The tour is organized into 13 stages, each focusing on a specific area of the platform. When a stage completes, the tour navigates to the next section and starts a new driver.js instance with that stage's steps.

home → dashboards → dashboard_editor → ai_assistant → workflows →
workflow_editor → integrations → notifications → command_palette →
settings_personal → settings_security → settings_ai → settings_org → complete

Route Validation

Each stage validates that the user is on the correct route before rendering its popover steps. This prevents random popovers from appearing if the user navigated away:

Stage	Expected Path
`home`	`/`
`dashboards`	`/dashboard*`
`dashboard_editor`	`/dashboard/*`
`ai_assistant`	`/`
`workflows`	`/workflow*`
`workflow_editor`	`/workflow*`
`integrations`	`/integrations`
`notifications`	`/notifications`
`command_palette`	Any (overlay)
`settings_*`	`/settings`
`complete`	Any

Architecture

Speed Run Tour
  ├── Stage: Home (7 steps)
  ├── Stage: Dashboards (3 steps)
  ├── Stage: Dashboard Editor (7 steps, interactive)
  ├── Stage: AI Assistant (5 steps, opens AI panel)
  ├── Stage: Workflows (2 steps)
  ├── Stage: Workflow Editor (4 steps, opens panels)
  ├── Stage: Integrations (3 steps)
  ├── Stage: Notifications (3 steps)
  ├── Stage: Command Palette (3 steps, opens palette)
  ├── Stage: Settings — Personal (4 steps)
  ├── Stage: Settings — Security (3 steps)
  ├── Stage: Settings — AI (3 steps)
  └── Stage: Settings — Organization (5 steps, final celebration)

Stage Details

Stage 1: Home (7 steps)

Introduces the main interface:

Welcome popover (center)
Navigation Sidebar — Main navigation hub
Quick Actions — New Workflow button, Alt+W shortcut
New Dashboard — Dashboard creation, Alt+D shortcut
Recent Items — Recently viewed dashboards and workflows
Keyboard Shortcuts — Power-user shortcuts (⌘J, Alt+W, Alt+D)
Notifications & Training — Alerts section and training docs

Stage 2: Dashboards (3 steps)

Navigates to /dashboard:

Dashboard hub overview
Dashboard management (personal/company/org scopes)
Transition: creates a new dashboard

Stage 3: Dashboard Editor (7 steps, interactive)

Navigates to /dashboard/new:

Editor introduction (activates edit mode)
Editor Sidebar — Configuration and layout controls
Add Tile — Opens the Tile Library modal automatically
Tile Library — Browse categories (charts, stats, forecasts, etc.)
Tile on Grid — Demonstrates drag, resize, and stacking
Editing Tiles — Opens the tile editor automatically
Tile Configuration — Data sources, visualization types, AI features

Stage 4: AI Assistant (5 steps)

Navigates back to /:

AI assistant introduction (Ctrl+/ shortcut)
Opens the AI panel automatically
AI Chat Panel — Overview of capabilities
Input Area — Text and voice input options
Transition to workflows

Stage 5: Workflows (2 steps)

Navigates to /workflow:

Workflow automation overview
Transition to workflow editor

Stage 6: Workflow Editor (4 steps)

Stays on /workflow:

Workflow Canvas — Drag-and-drop node design
Node Library — Auto-opens if collapsed; shows triggers, transforms, outputs
Properties Panel — Auto-opens if collapsed; shows node configuration
Connecting Nodes — Explains drag handle-to-handle connections

Stage 7: Integrations (3 steps)

Navigates to /integrations:

Integration hub (Google Drive, OneDrive, Gmail, Teams, etc.)
Custom API Builder — Build custom integrations
Transition to notifications

Stage 8: Notifications (3 steps)

Navigates to /notifications:

Notification center overview
Severity & filter system (critical, warning, info)
Transition to command palette

Stage 9: Command Palette (3 steps)

Returns to / and opens the palette overlay:

Opens the Command Palette automatically
Command Palette — ⌘J (Ctrl+J) shortcut
Search Everything — Instant filtering of dashboards, workflows, pages

Stages 10–13: Settings (15 steps total)

Navigates to /settings and clicks through tabs:

Personal: Appearance, Dashboard & Sidebar, Profile
Security: Password, 2FA, Passkeys, Usage & Tokens, Billing
AI: Provider selection, Query settings, AI Context (custom instructions)
Organization: Users, Companies, Roles & Permissions, App Settings
🎉 Tour Complete — Celebration message, returns to home

Settings

Tour Controls

The Speed Run can be controlled via the following:

Action	Description
Start Tour	Click "Start Speed Run" on the home page
Exit Tour	Click the X button on any popover
Auto-Start	Triggers automatically on first login
Progress	Step counter shown in each popover

Visual Configuration

Setting	Value
Step Progress	Shown — displays current step count
Animations	Enabled — smooth popover transitions
Exit Allowed	Yes — users can close via the X button
Backdrop	Semi-transparent overlay highlighting the current element

Data Expectations

First Login Detection: The Speed Run automatically starts on a user's first login to the platform.
Page Loading: Each stage waits for the target page to fully load before displaying its steps.
Interactive Elements: Several stages interact with the application (opening modals, creating tiles, toggling panels) to demonstrate features in context.

Use Cases

1. New User Onboarding

New team members get an immediate, hands-on tour of the platform when they first log in. No documentation reading required.

2. Feature Discovery

Even experienced users may not know about features like the command palette (⌘J), voice input, or auto-layout. The Speed Run showcases every capability.

3. Training & Demos

Use the Speed Run during demos or training sessions to provide a structured walkthrough. Restart it anytime from the home page.

Exiting the Tour

Users can exit the Speed Run at any time:

Click the X on any popover to end the tour immediately.
Navigate away — The route validation prevents orphaned popovers from appearing.
The tour state resets to home and isSpeedRunActive is set to false.

← PreviousPlatform Summary Next →Overview