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 guideThe 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 — Help & Reference
Everything you need to use the dashboard confidently. No technical experience required.
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 (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).
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.
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:
- 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
- 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
- Customer — someone you sell to and deliver for
- Vendor — a supplier you purchase equipment from
- Both — companies you both buy from and sell to
- 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
- 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
- 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
- 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
- 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
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.
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.
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.
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.
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.