Skip to main content

Your GymSpotter OS workspace

A module is a group of pages that help with one part of your business. Marketing plans campaigns. Leads tracks future customers. Warehouse tracks equipment. Dispatch plans deliveries. Finance tracks money. Reports shows every company's calls, forms, texts, ad results and monthly client reports. Dashboard, Search, Customers, Settings, Integrations, and this guide support all six modules.

The app loads local files through the GymSpotter OS launcher. Marketing drafts and manual leads work offline. Live advertising, social publishing, email delivery, and outside services need configured connections. Cloud AI needs a provider key and network access; a local model can use your computer.

Download the plain-language feature guide

The interface includes keyboard controls, visible focus, labeled fields, responsive layouts, and reduced motion support. A manual screen reader and accessibility review is still needed before claiming full WCAG 2.2 AA or ADA compliance.

GymSpotter OS

GymSpotter OS — Help & Reference

Everything you need to use the dashboard confidently. No technical experience required.

v8.2.0
Jump to: Learning Center Core Workflow All Sections Folder & Files Order Statuses Tips & Shortcuts Useful Links Reports & Integrations Businesses, Company & Team
Learning center

An explainer video and a guide for every module and page. The Guide button in the top bar (or F1) opens the guide of the page you are on, and the AI co-pilot reads these same guides to help you.

Reports module & Integrations

Reports (sidebar → Reports module) is the former GymSpotter Reports app, now part of the OS. For each company it shows calls, texts and website forms, Google Ads and Meta Ads results, SEO rankings, a lead map, lead sources, every lead's history, and the monthly client reports (interactive HTML and Letter PDF). It shows the business you are in (switch businesses with the arrow beside the sidebar logo); a business without Reports gets a Set up Reports button. Hide contact info masks names, phone numbers and emails before you share your screen.

Getting data in: Reports → Import & sync. Pick the export (800.com Calls and Messages CSVs, the Google Takeout of form or text emails, Google Ads tables, Meta Ads campaign / ad set / ad exports, GA4, Search Console, Ahrefs, HubSpot deals), choose the months it covers and drop the files in. Or pull through the API for platforms connected in Integrations. Monthly reports → Build report writes a month's report.

Integrations (the Integrations button in the top bar, Settings → Integrations, or sidebar → Settings) holds every connection: QuickBooks, Google Sheets, Grasshopper, HubSpot, 800.com, website forms (Gmail), Google Ads, Meta Ads, GA4, Search Console, Ahrefs and the Google sign-in. Click the button itself to open the full panel; the arrow beside it shows each connection's status. Tokens are stored on this computer only; Test checks one with a single read-only call.

AI agents (MCP): Integrations → MCP servers lets Claude and other agents work with GymSpotter OS and your ad platforms. The OS's own AI panel on the Reports page can also read the Reports data. The Reports module needs Node.js 18 or newer, which Start GymSpotter OS.cmd uses automatically.

Desktop & phone apps: Start GymSpotter OS.cmd runs GymSpotter OS in the background and opens the installed GymSpotter OS app; the first time it installs the app (Chrome or Edge), and it sets GymSpotter OS to start when you sign in to Windows, so the app icon always works. Its window counts down from 5 before it closes. Stop GymSpotter OS.cmd stops it. In a browser tab, the Get the GymSpotter OS apps window (also in the bell) installs the desktop app in one click and shows a QR code for your phone once this computer shares GymSpotter OS over a secure link (GYMSPOTTER_PUBLIC_URL in .env).

Businesses, Company & Team

Several businesses, one GymSpotter OS. The arrow beside GymSpotter OS at the top of the sidebar lists your businesses (Gym Tech Fitness, Fit Movers 123); choose one and GymSpotter OS reloads as that business. The name under the logo shows which one you are in. Add a business… in the same menu creates its own folder at the top of the GymSpotter OS folder, with Company, Invoices, Purchases, Orders, Inventory, Customers and Sessions inside. Each business keeps its own folders, Reports data, profile, team and saved browser data (invoices, leads, connections, AI chat); your own preferences, such as dark mode, are shared.

Company & Brand Kit (sidebar → Company & Team) is the business's profile: name, logo, colors, phone, email, website, address, year started, services, letterhead tagline, payment terms, signature, legal and social links. Invoices, purchase orders, delivery slips, printed tables and emails use it, and a live preview shows the letterhead before you save. Its Brand voice for AI section (tone, audience, key messages, words to use and avoid, style rules, examples) becomes the AI brand brief the AI helper follows whenever it writes for the business.

Team & Assignments lists the people at the business and everything assigned to them: tasks, jobs (dispatch orders), sales (invoices), leads (including Reports calls and forms) and customers, each with a status, priority and due date. Every change goes into the History, and each person shows open and overdue work, what they finished in the last 30 days, completion rate and average days to done. Add a person's other names under Also known as and invoices with that QuickBooks sales rep, or leads with that owner, are suggested for their list.

The Core Workflow — Start Here

Every delivery starts with an invoice. Always.

This dashboard is built around a simple four-step process. Every order flows through each step in order — you can't skip steps. Here's how it works:

Step 1 — Invoice
Create the invoice
Add customer details, line items, and send to your customer for payment.
Step 2 — Payment
Mark the invoice Paid
Once the customer pays, change the status to Paid. A Convert button will appear.
Step 3 — Dispatch
Convert to a dispatch order
Click "Convert to Dispatch Order" on a paid invoice. This signals the Grasshopper warehouse automatically.
Step 4 — Inventory
Inventory updates automatically
Stock is automatically reduced when the dispatch order is created. No manual counting needed.
Good to know: If you need to enter a dispatch order that wasn't created from an invoice (e.g. importing a Grasshopper CSV export), use the Dispatch Orders page → Import CSV, or the New Dispatch Order page. The invoice-first path is the recommended approach for new orders.
What Each Section Does
Dashboard
Your command center. At a glance you can see:
  • Total dispatched, delivered, in transit, and exceptions
  • A mini calendar showing upcoming scheduled deliveries
  • Hub inventory status cards — click any hub to filter inventory
  • A chart showing your order status breakdown
  • Quick lookup by Order ID or PO number
  • Live webhook event feed from Grasshopper
Tip: Click any tile or chart slice to jump straight to the filtered dispatch list.
Global Search
Search across everything — invoices, POs, dispatch orders, and inventory — all at once.
  • Search by order ID, invoice number, customer name, SKU, or status
  • Use the quick-filter shortcuts for common lookups (e.g. "Paid invoices", "Zero stock")
  • Click any result to jump directly to that record
Shortcut: Press ⌘K from anywhere to open Global Search instantly.
Customers / Address Book
Your contact database for both customers and vendors.
  • Customer — someone you sell to and deliver for
  • Vendor — a supplier you purchase equipment from
  • Both — companies you both buy from and sell to
Auto-fill: When creating an invoice or PO, start typing a customer name and the form will auto-fill address, email, and phone from your address book.
Invoices
Create, manage, and track customer invoices.
  • Click New Invoice to build one from scratch with line items, tax, and discounts
  • Save as a PDF and it automatically goes into your Invoices/ folder
  • Change the status using the dropdown on any row: Draft → Sent → Paid → Converted
  • Once Paid, a purple Convert to Dispatch button appears on the row
  • Import existing invoice CSV files from QuickBooks or other systems
Purchase Orders
Manage orders you place with your equipment vendors.
  • Create a PO with vendor details, items, and expected delivery
  • Track status: Draft → Sent → Partial → Received
  • When you receive goods, click the green box icon to log receipt quantities — stock is added to inventory automatically
  • Attach vendor invoices and packing slips directly to any PO row
Dispatch Orders
Track and manage all your delivery orders.
  • Filter by status, service level, region, or date range
  • Switch to Calendar View to see deliveries by scheduled date
  • Use the Kanban Board to drag orders between status columns
  • Import a CSV export from Grasshopper to bulk-load orders
  • Color-coded rows: green=delivered, blue=in transit, amber=pending, red=exception
Inventory
Track your equipment stock across all warehouse hubs.
  • Upload your SKU spreadsheet (CSV or Excel) — columns are auto-mapped
  • Switch between multiple files using the tab bar at the top
  • Toggle to By Hub view to see stock levels per location
  • Red alert banner appears on the Dashboard if any SKU hits zero stock
  • Use Register SKU to manually add a new item, or Move Stock to transfer between hubs
Shipping Calculator
Get a live shipping quote using the Grasshopper API.
  • Enter origin ZIP (warehouse) and destination ZIP (customer)
  • Select the service level (White Glove, Threshold, Curbside, etc.)
  • Add one or more items — each needs weight, cube (cu ft), and quantity
  • Click Calculate to get the total, linehaul breakdown, fuel surcharge, and estimated delivery window
  • Previous quotes are saved in Quote History for this session
Requires: The Grasshopper bridge must be connected in Settings → Bridge.
Your GymSpotter OS Folder — How Files Work

Everything this app creates or saves lives in a folder called GymSpotter OS on your computer's Desktop. Think of it like a filing cabinet — the app reads and writes to it automatically. You never need to dig through the folder manually, but it's always there as your backup.

Your Desktop
GymSpotter OS/ ← the main folder
Invoices/ — PDFs of every invoice you create or receive
Purchases/ — Purchase order PDFs and vendor documents
Orders/ — Dispatch order CSV exports from Grasshopper
Inventory/ — Your SKU spreadsheets (CSV or Excel)
Customers/ — Customer and vendor files and attachments
Connecting the folder
Go to Settings → Folder and click Connect GymSpotter OS Folder. A file picker opens — select the folder if it exists, or select your Desktop and we create it for you.
Sidebar file tree
Once connected, the bottom of the left sidebar shows all your files organized by subfolder. Click any file to preview it inside the relevant page panel.
Attaching files to records
Every invoice, PO, dispatch order, and customer has a paperclip button. Click it to attach a PDF or document — it gets saved to the correct subfolder and linked to that record.
Drag and drop files
You can drag any PDF or CSV directly into the file browser side panel (click the arrow button at the bottom of the sidebar) and drop it into the correct subfolder.
Dispatch Order Statuses — What They Mean
Pending Arrival — The order is created and the warehouse is expecting the goods to arrive.
Pending Pickup — Waiting for the carrier or driver to pick up from the warehouse.
Received — Goods have arrived at the warehouse hub and been checked in.
Out For Delivery — The truck is on the road. The delivery crew is heading to the customer's location now.
Delivered ✅ — Successfully delivered and signed off. This is the happy ending.
Customer Pickup — The customer collected the order themselves from the warehouse.
Delivery Failed — The driver attempted delivery but could not complete it. Contact the customer to reschedule.
Damaged — The item was damaged in transit or during delivery. Document and escalate immediately.
Hold — The order is paused. This is usually due to a customer request, a dispute, or a warehouse issue. Check the hold reason on the order.
Cancelled — The order has been cancelled. Note: orders already loaded for delivery cannot be cancelled via the dashboard — call dispatch directly.
Returned — The item has been returned to the warehouse. Inventory is updated once the return is processed.
In Transit — The order is moving between facilities or on a long-haul leg before the final delivery hub.
Service Levels
White Glove
Full service — deliver, unbox, place, and assemble in the room of choice. Highest level.
Room of Choice
Deliver to the room the customer wants. No assembly. May include debris removal.
Threshold
Deliver just inside the front door or garage. No placement inside the home.
Curbside
Drop off at the curb outside the customer's home. Customer handles moving it inside.
B2B
Business-to-business delivery. Loading dock or commercial receiving. No residential setup.
Will Call
The customer picks up from the warehouse. No delivery needed.
Blanket Wrap
White-glove packing with furniture-style wrapping. Used for fragile or high-value items.
Express
Priority expedited delivery with faster transit times.
Parcel
Small-box shipping. Sent via standard parcel carrier like UPS or FedEx.
Tips, Shortcuts & Common Tasks
Keyboard Shortcuts
Press ? at any time to see all shortcuts. Most useful ones:
Open Global Search⌘K
Go to DashboardGD
Go to InvoicesGI
Go to DispatchGO
Go to InventoryGW
New InvoiceNI
Focus page search/
Common Tasks
Find a specific order: Use Global Search (⌘K) and type the order ID, customer name, or PO number.
Update an order status: On the Dispatch Orders list, click the status dropdown on any row. Or right-click any order ID chip for more options.
Import a Grasshopper CSV: Go to Dispatch Orders → Import CSV. Drag and drop your GH export file or click Browse.
Check stock levels: Go to Inventory and use the Hub filter or toggle to "By Hub" view. The Dashboard also shows a hub summary.
Print an invoice or PO: Click the print icon on any row, or open the full detail view and click Print.
Export data to Excel: Every section has an Export CSV button in the toolbar. Open in Excel or Google Sheets.
Settings Overview
Click the Settings button in the top right to access:
Bridge — Connect to the Grasshopper bridge (required for live order creation and shipping quotes)
Sheets — Connect your Google Sheet for live inventory sync
Folder — Connect your GymSpotter OS folder on your Desktop
Columns — Show or hide inventory table columns
QuickBooks — Connect QuickBooks Online to sync invoices and bills
Theme — Switch between light and dark mode
Things to Know
Creating a dispatch order is a live action. Using the "New Dispatch Order" page immediately signals the Grasshopper warehouse. Use the invoice-first convert path whenever possible.
Data in this session only. Dispatch order data loaded from CSV lives in your browser session. If you close the tab, you'll need to re-import the CSV. Connect a folder or Google Sheets for persistence.
Cancelling in-transit orders. Orders already loaded for delivery cannot be cancelled through the dashboard — you must contact dispatch directly by phone.
Inventory auto-decrement. When a dispatch order is created from a paid invoice, matching SKUs are automatically reduced. Double-check your SKU codes on line items so inventory stays accurate.
GymSpotter OS v8.2.0 — Built by GymSpotter.dev. Questions or issues? Contact your system administrator.