Skip to content
Get CalGrid

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
  • 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

When documentation or bug reporting is opened, an integrated Browser Tab (with a 🌐 globe icon) appears on the tab bar alongside workspace tabs.


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)

Edit this page on Git