Interface Overview
CalGrid uses a compact, high-density desktop interface. This page explains every area of the main window.
Window Layout
┌─────────────────────────────────────────────────────────────────────┐│ Title Bar [● ● ●] CalGrid VERIFIED [Safe|Normal|Fast|Ultra] ⚙ │├──────────────────────────────────────────────────────────────────────┤│ [Workspace 1] [Workspace 2] [+] │ ← Tab Bar├────────────┬─────────────────────────────────────────────────────────┤│ │ 📅 Event Details │ 📧 Receivers ││ Sidebar │ Name / Date / Link / Msg │ Upload / Dedupe / List ││ │ │ ▶ Start ❚❚ Pause ■ Stop ││ Workspace │─────────────────────────── │────────────────────────────││ Google │ Progress │ Stats (Total/Done/Fail) ││ Advance │ ████████░░ 60% │ ││ │─────────────────────────── ┴────────────────────────────││ │ ⚡ Create Google API: 1.Project 2.Enable 3.Consent… │├────────────┴─────────────────────────────────────────────────────────┤│ 🏷 Tags ● Ready ⚡ Normal Mode ⚡Debug 📄Docs ❓Help ℹ️ v1.0.2│└─────────────────────────────────────────────────────────────────────┘Title Bar
The dark title bar at the top of the window contains:
| Element | Purpose |
|---|---|
| ● (red dot) | Close the application |
| ● (yellow dot) | Minimize to taskbar |
| ● (green dot) | Maximize or restore window size |
| CalGrid logo + name | Application branding |
| VERIFIED badge | License status indicator |
| Mode Selector | Switch dispatch mode (Safe / Normal / Fast / Ultra) |
| ● status dot | Green = Google account connected; Grey = not connected |
| Account email | Shows connected Google account for active tab |
| ⚙ Settings | Opens the Settings dialog (Ctrl+,) |
You can drag the title bar to move the window. Double-click to maximize or restore.
Tab Bar
The tab bar below the title bar manages your workspaces.
| Element | Purpose |
|---|---|
| Workspace tabs | Each tab is an independent campaign workspace |
| Active tab | Highlighted with an indigo top border — this is your current workspace |
| × on each tab | Close that workspace tab |
| + button | Create a new workspace tab |
| ‹ › arrows | Scroll through tabs when many are open |
Each workspace tab shows an authentication status dot and a live progress badge:
- Connection Dot:
- Green (
#16a34a) — Google account connected and authorized - Grey (
#cbd5e1) — No Google account connected
- Green (
- Progress Badge (shown during or after dispatch):
- Amber badge (e.g.,
45%) — Job is actively running - Cyan badge (e.g.,
❚❚ 45%) — Job is currently paused - Green badge (
✓) — Campaign completed successfully - Red badge (
✗) — Campaign was cancelled or stopped
- Amber badge (e.g.,
When documentation or bug reporting is opened, an integrated Browser Tab (with a 🌐 globe icon) appears on the tab bar alongside workspace tabs.
Left Sidebar
The 206px sidebar on the left side of each workspace has three sections:
Workspace Section
- Name field — editable workspace name (locked during active dispatch)
Google Auth Section
- + Add / ✓ JSON — select your OAuth credential JSON file
- 🔗 Connect / 🔓 Disconnect — authorize or revoke Google Calendar access
- Status indicator — shows connecting, verifying, or connected state
Advance Section
- 🏷️ Brand Name — configure brand identity for this workspace
- Brand label — shown when brand is active (e.g., ”● Acme Corp”)
- 📎 Event Attachment — attach files via Google Drive
- ⚙ (gear icon) — configure custom attachment display name
Main Content Area
The main area has four panels arranged in a 2×2 grid:
📅 Event Details (top-left, tall panel)
Covers the full left column and contains:
- Name (event title) — the calendar event title
- Date & Time — date picker with calendar popup, time in AM/PM format
- Meeting Link / Location — URL or venue address
- Message (Description) — rich text invite message with Live Preview and Template Tags
📧 Receivers (top-right)
- 📁 Upload List — import emails from CSV/Excel/text files
- ✂ Remove Duplicates — deduplicate the current list
- Email text area — paste or type recipient emails
- Status counter — shows number of valid recipients
- ▶ Start / ❚❚ Pause / ▶ Resume / ■ Stop — dispatch control buttons
📊 Progress (bottom-right)
- Percentage complete
- Progress bar
- Total / Done / Fail / Left stat cards
⚡ Google API Quick Setup Bar (bottom, full-width)
Five clickable step buttons that open the correct Google Cloud Console pages for initial setup.
Bottom Status Bar
The thin dark bar at the very bottom of the window:
| Element | Location | Purpose |
|---|---|---|
| 🏷 Tags | Left | Open the dynamic tags reference modal |
| ● Ready / Working / Paused | Left-center | Live dispatch status |
| ⚡ Normal Mode | Left-center | Current dispatch mode badge |
| ⚡ Debug | Right | Open diagnostics dialog |
| 📄 Docs | Right | Open documentation in built-in browser |
| ❓ Help | Right | Open help resources |
| 🐛 Report | Right | Open issue reporting |
| ℹ️ About | Right | Open About dialog with version and shortcuts |
| v1.0.2 | Far right | Application version |
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl + T |
Create new workspace tab (Note: About modal cheat sheet lists Ctrl+N, but active runtime shortcut is Ctrl+T) |
Ctrl + W |
Close active workspace tab |
Ctrl + Tab |
Switch to next workspace tab |
Ctrl + Shift + Tab |
Switch to previous workspace tab |
Ctrl + , |
Open Settings dialog |
Ctrl + B |
Toggle navigation sidebar |
Ctrl + F |
Focus search bar in Settings dialog |
Escape |
Dismiss open dialogs and modals (or clear search input) |