Documentation | GridBee

GridBee documentation.

Google Sheets is the world's most popular data tool.

GridBee makes it the world's most powerful one.

One Extension. One App. One Solution

GridBee documentation.

Everything you need to install GridBee, run each module, and manage your account. Quick reference at the top, deeper guides per module below.

Install

GridBee ships as a Chrome MV3 extension. Add it from the Chrome Web Store with one click — no account creation, no email confirmation, no onboarding wizard.

Open the GridBee listing on the Chrome Web Store.
Click Add to Chrome, then confirm Add extension.
(Optional) Pin GridBee to your toolbar from the puzzle-piece menu.

Works in Chrome, Brave, Arc, and Edge (Chromium 114+).

Open the side panel

GridBee lives in Chrome's side panel and is enabled automatically on Google Sheets and the Apps Script editor.

Click the GridBee toolbar icon, or
Press Alt+Shift+G on any supported page.

The panel persists across tabs in the same window. Closing the side panel keeps your session alive — it'll re-open instantly.

Sign in

GridBee uses Google OAuth via chrome.identity, exchanged for a Firebase ID token. The first time you click any module that needs an authenticated call, a Google chooser pops up. Pick the account you use for Workspace.

Scopes requested (one-time consent):

openid, userinfo.profile, userinfo.email — sign-in identity
script.projects.readonly — read your Apps Script projects (Vaps)
spreadsheets, documents, presentations — read/write the file you have open
drive.file — only files you pick via the Drive Picker (avoids broad Drive access)
calendar.events — create calendar events from the Automation runner

You can revoke any scope at any time at myaccount.google.com → Security → Third-party apps.

Free trial

Every new account starts on a 14-day free trial with full access to every module. No credit card required. The countdown begins the moment your account is created and is shown on the home pane.

When the trial ends, GridBee falls back to the Free tier automatically — your data stays intact and you can upgrade any time.

Module 01 — Mastery

Assess your Sheets skill and earn a verifiable badge.

The assessment

50 questions, drawn from a 1,000+ question bank.
45-minute timer, kicks in the moment you click Start.
10 sections — Foundations through Pivot Tables.

Scoring & bands

0–49 Beginner
50–69 Foundational
70–84 Proficient
85–94 Advanced
95–100 Mastery

Pass and you get a downloadable badge with a verify URL anyone can check.

Module 02 — Flow

Mobile data entry, straight into your spreadsheet.

Open the Flow pane. You'll see a QR code.
Scan it from your phone (or go to flow.gridbee.app).
Add it to your home screen for app-like access.
Pick a sheet from the list. Headers in row 1 become form fields.
Fill it in and submit — rows land back in your sheet instantly.

Module 03 — Stylist

Clean up Sheets in one click, or generate a full brand style.

Quick formats

17 one-click actions grouped into 4 categories:

Sheet Tabs — show, hide, sort, delete empty.
Rows & Columns — resize, unhide, trim ranges.
Formatting — notes, hyperlinks, colours.
Data — trim whitespace, unmerge, formulas → values.

Star the ones you use most — they float to the top of the panel.

Brand style generator

Pick a tone, audience and palette, then click Generate Style. Stylist builds a reusable preset you can apply across sheets.

No Apps Script required

Flow talks to your sheets through GridBee's authenticated connection. There are no triggers to install, no webhooks to configure.

Module 04 — Vaps

Export and validate Apps Script projects.

Export formats

Merged .gs — every file concatenated in dependency order.
JSON — full project tree with metadata.
Markdown — human-readable brief with headings per file.

Destinations

Clipboard — paste straight into a PR.
Device — download as a single file.
Drive — save into a folder you pick via the Drive Picker.

Optional: enable AI Code Review in settings for a 7-dimension quality score (correctness, security, reliability, performance, maintainability, documentation, best practices).

Module 05 — Automation

Run Workspace automation from any sheet. One row in, one Doc/deck/sheet/folder/event out.

Five flavours

Sheet → Docs — mail-merge a Doc template.
Sheet → Slides — generate a deck per row.
Sheet → Sheets — spin up a spreadsheet per row.
Sheet → Folders — create Drive folders, optionally nested.
Sheet → Calendar — schedule events on any calendar.

How it runs

Open the Automation pane and pick a flavour.
Configure the template/folder/calendar.
Tick the Trigger column in the rows you want to process.
Hit Run. GridBee writes Status, Run At, and the output URL back into each row.

Failed rows stay in error state with the reason inline — fix and re-tick to retry.

Module 06 — Health

Diagnose your sheets on demand.

What Health checks

Errors — #REF!, #N/A, #VALUE!, #DIV/0!, #NAME?, #NUM!, #NULL!.
Volatile formulas — NOW, TODAY, RAND, RANDBETWEEN, INDIRECT, OFFSET.
Performance — cell usage vs. the 10-million-cell per-spreadsheet quota.

Each tab gets a 0–100 score and a severity band: Healthy (90+), Mostly healthy (75+), Needs attention (50+), Critical (<50). Click a row to jump to the offending cell.

Account & settings

Open the Account pane (avatar in the top-right of the home tile) to manage your profile and preferences.

Profile — name, email, photo (from your Google account).
Notifications — toggle in-product notifications.
Module flags — enable optional features like AI Code Review.
Sign out — clears the local cache; Firestore data is untouched.

Billing

GridBee Pro is $49/month, billed through Lemon Squeezy. Open Account → Upgrade to start a subscription.

Email is prefilled on the Lemon Squeezy checkout so your subscription matches your GridBee account automatically.
Renewals are monthly; the Cloud Run webhook updates your status on each subscription_payment_success.
A failed renewal puts your subscription in past_due for the retry window — Pro features stay available.
Cancel any time from the customer portal link in your Lemon Squeezy receipt email. Pro stays active until the period you've already paid for ends.

Refunds

14-day money-back guarantee on the first paid charge. Email gridbee@briltek.cloud with your transaction reference and we'll refund within 5–10 business days. Full policy: refund policy.

Keyboard shortcuts

Alt+Shift+G — open / focus the GridBee side panel
Esc — close any modal inside the panel
Enter — submit the active form (Mastery answer, Stylist preset, etc.)

Customise the shortcut at chrome://extensions/shortcuts.

Placeholder syntax

The Automation runner replaces tokens wrapped in double curly braces with the value from the matching column in each row.
{{Name}} — value of the column titled Name.
{{Customer Email}} — column titles can include spaces.
Matching is case-insensitive and ignores leading/trailing whitespace.
Missing columns are replaced with an empty string; the row still processes.

Placeholders work inside Doc bodies, Slides text frames, Sheets cells, and Calendar event titles/descriptions.

Data & privacy

Your sheets, docs, decks, and calendar live in your Google Drive — GridBee only touches the file you have open. Settings and module state sync to users/{uid} in Firestore so the panel feels the same across devices.
We never sell, share, or use your data for model training.
Local cache lives in chrome.storage.local and is reconciled from Firestore on every boot.
Feedback you submit goes to a feedback/ collection in our Firestore — we read it manually.
Full privacy policy covers data flow, retention, and your rights.

Troubleshooting

"Open a Google Sheet first."

The active tab isn't a Sheet (or Apps Script project). Switch to the file you want to work on and click Run again.

The side panel won't open

Check that GridBee is enabled at chrome://extensions. Some corporate Chrome policies block side panels — talk to your admin.

I clicked Upgrade but Pro features didn't unlock

Paystack confirms the charge first, then our webhook flips your account to Pro. There can be a 1–2 minute lag. If it's been longer, sign out and back in, or email us with your transaction reference.

Flow says "no sheets available"

Make sure you've opened Flow on the phone with the same Google account you used to install GridBee. Different accounts won't see each other's sheets.