Popup AI Chat Documentation
Overview
The Popup AI Chat is a full-window variant of the Vantage AI assistant that opens in a separate browser window. It provides the same chat capabilities as the sidebar assistant — streaming responses, conversation management, voice input, and context-aware prompts — but in a dedicated, full-screen interface. The popup maintains real-time context with the parent application window automatically.
Purpose
The Popup AI Chat gives users the flexibility to move the AI assistant into its own window, allowing them to:
- View the AI chat and the Vantage app side-by-side on dual monitors.
- Maximize screen real estate for the main application while keeping the chat accessible.
- Continue chatting even while navigating between different pages in the parent window.
How It Works
Pop-Out Flow
- User triggers pop-out — Via the hamburger menu → "Pop Out Window" or
Ctrl+Shift+Pin the sidebar assistant. - New window opens — A separate browser window is created with the popup chat interface.
- Sidebar hides — The main sidebar assistant hides while the popup is active.
- Context forwarding — The parent window sends page context updates to the popup automatically.
- Return flow — Clicking "Return to Main" closes the popup and restores the sidebar.
Architecture
Popup AI Chat (separate browser window)
├── Header
│ ├── Intuidy AI Chat branding
│ ├── Temporary Chat badge (if active)
│ ├── Hamburger Menu
│ │ ├── New Chat (Ctrl+N)
│ │ ├── Temporary Chat (Ctrl+Shift+T)
│ │ ├── Delete Current Chat (Ctrl+Shift+D)
│ │ └── Recent Chats List
│ └── Return to Main button
├── Messages Container
│ ├── Empty State (logo + smart prompts)
│ ├── User Messages (blue bubbles)
│ ├── Assistant Messages (gray bubbles, formatted content)
│ └── Loading Indicator
└── Input Area
├── Text Input
├── Voice Button (mic / stop)
└── Send Button
Parent–Popup Communication
The popup and parent window communicate seamlessly in the background:
- Page context updates — When you navigate in the main window, the popup immediately knows what page you're on.
- Close notification — When the popup closes, the sidebar is automatically restored in the main window.
Security: Messages between windows are validated to prevent cross-origin injection.
Context Priority
The popup uses a dual-context system with the following priority:
- Parent context (received from the main window) — preferred, reflects the actual page the user is viewing.
- Local context (from the popup window itself) — fallback if no parent context is available.
Navigation Actions
When the AI suggests navigating to a page:
- If the main window is still open, navigation occurs in the main window, not the popup.
- If the main window is closed, navigation occurs in the popup itself.
- Same safe-path restrictions apply as the sidebar assistant.
Settings
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+N | Start a new conversation |
Ctrl+Shift+T | Start a temporary (unsaved) chat |
Ctrl+Shift+D | Delete the current conversation |
Conversation Features
All conversation management features from the sidebar assistant are available:
| Feature | Description |
|---|---|
| New Chat | Creates a new conversation, auto-titled from the first message |
| Temporary Chat | Ephemeral chat that won't be saved |
| Rename | Click the pencil icon in the conversation list |
| Delete | Click the trash icon or use Ctrl+Shift+D |
| Conversation Switching | Click any conversation in the Recent Chats list |
Data Expectations
- AI Availability: Shows an "AI is not available" message with a "Return to Main Window" button if AI is not enabled.
- Loading State: Displays a spinner while AI availability is being checked.
- Streaming: Uses the same real-time streaming as the sidebar assistant.
- Voice Transcription: Same voice input capabilities and 25 MB limit.
Use Cases
1. Dual-Monitor Setup
Pop out the AI chat to a second monitor. Continue browsing dashboards and workflows on the primary screen while asking questions in the chat window.
2. Extended AI Sessions
For lengthy analysis sessions, the full-window interface provides more reading space than the sidebar panel.
3. Side-by-Side Comparison
View AI analysis alongside the data it's referencing. The popup automatically receives context from whichever page you're viewing in the main window.