Launch Dashboard - Google Sheets Integration

Cross-device task tracking for The Wandering Lantern grand opening campaign.


What Is This?

A complete proof-of-concept showing how to use Google Sheets as a database for your launch dashboard. No server needed, works across all devices, free forever.


Files in This Folder

πŸ“Š poc-sheets.html - The Dashboard POC

What it does:

How to use:

  1. Open in browser (Chrome, Safari, Firefox, etc.)
  2. Click "Load Demo" to test without setup
  3. OR enter your Sheet ID + Apps Script URL to connect to real data

βš™οΈ google-apps-script.js - Backend for Writes

What it does:

How to use:

  1. Open your Google Sheet
  2. Go to Extensions β†’ Apps Script
  3. Paste this code
  4. Deploy as Web App
  5. Copy the URL into dashboard

πŸ“– SETUP-GOOGLE-SHEETS.md - Complete Setup Guide

What it covers:

Start here if: You want to set up the real thing with your Google Sheet.

πŸ“„ index.html - Main Dashboard Landing Page

What it does:

Status: Already created, uses localStorage (device-specific)


Quick Start Options

Option 1: Test the Demo (30 seconds)

1. Open poc-sheets.html in browser
2. Click "🎯 Load Demo"
3. Check/uncheck boxes to see it work

Result: See how the interface works, no setup needed.


Option 2: Connect to Real Google Sheet (10-15 min)

1. Follow SETUP-GOOGLE-SHEETS.md
2. Create Google Sheet with your tasks
3. Deploy Google Apps Script
4. Connect dashboard to Sheet
5. Use on all your devices!

Result: Full cross-device task tracking with Google Sheets.


Why Google Sheets?

You asked: "I like the google sheet option but does that really work? can we do a super quick POC?"

Answer: Yes, it really works! Here's why it's great:

βœ… Advantages

  1. No server needed - Google hosts everything
  2. Free forever - No monthly database fees
  3. Familiar interface - You know how to use Sheets
  4. Cross-device - Phone, laptop, tablet all sync
  5. Visual - See all tasks in spreadsheet view
  6. Quick setup - 10-15 minutes, one time
  7. Easy backup - Download Sheet as Excel/CSV anytime
  8. Flexible - Add columns, notes, formulas whenever

⚠️ Limitations

  1. Initial setup - Need to deploy Apps Script once (10 min)
  2. Sync delay - Auto-refresh every 30 seconds (not instant)
  3. Scale limit - Fine for 50-100 tasks, not ideal for 10,000+
  4. Public URL - Apps Script URL is public (but only works with your Sheet ID)

πŸ”„ Alternatives We Discussed

If Google Sheets doesn't work for you:


How It Works

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Emily's Phone  │──┐
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
                     β”‚     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”œβ”€β”€β”€β”€β†’β”‚   Google Sheet      β”‚
β”‚ Michael's Laptop│───     β”‚  (Your Database)    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚              ↑
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚              β”‚
β”‚   Your Tablet   β”‚β”€β”€β”˜              β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜          β”Œβ”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”
                             β”‚ Apps Script   β”‚
                             β”‚ (Web App)     β”‚
                             β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Data Flow

Reading (No Auth Needed):

  1. Dashboard fetches: https://docs.google.com/spreadsheets/d/{SHEET_ID}/gviz/tq?tqx=out:json
  2. Google returns task data as JSONP
  3. Dashboard renders checkboxes

Writing (Requires Apps Script):

  1. User checks box
  2. Dashboard POSTs to Apps Script URL with row/column/value
  3. Apps Script updates Google Sheet
  4. Next auto-refresh shows updated data on all devices

What's Next?

Immediate (You Choose)

  1. Test the demo - Click "Load Demo" in poc-sheets.html
  2. Read the setup guide - Open SETUP-GOOGLE-SHEETS.md
  3. Set up your Sheet - Follow the 4-step process
  4. Try it on 2 devices - See the sync work!

After POC Works

  1. Add all 47 tasks to your Google Sheet
  2. Integrate into main dashboard - Replace localStorage with Sheets
  3. Add week navigation - Switch between Week1, Week2, etc.
  4. Customize UI - Add filtering, search, categories
  5. Add metrics tracking - Progress charts, completion stats

Full Dashboard Features (Planned)


Files You Already Have

From previous work:

Print-Friendly Documents

Interactive Dashboard (Partial)

Setup & Reference


Status

βœ… Completed:

⏳ Next Steps (Pending Your Decision):

❓ Your Decision Needed: Do you want to:

  1. Try the POC first - See if Google Sheets works for your workflow
  2. Go all-in - Set it up now and start using it
  3. Explore alternatives - Look at Supabase or other options
  4. Keep it simple - Use localStorage + manual updates

Questions to Consider

Before setting up, think about:

  1. Who needs access?

  2. What devices will you use?

  3. How often will you update?

  4. What happens after opening?


Support

If you need help:


The Bottom Line

You asked: "Does Google Sheets really work as a database?"

Answer: Yes! This POC proves it:

Try it: Open poc-sheets.html β†’ Click "Load Demo" β†’ See for yourself!


Created for The Wandering Lantern "Follow the light, find the wonder"

Nov 3, 2025 - 25 days until grand opening! πŸŽ‰πŸ“šβœ¨