Coaster

\n \n

Coaster

pull up a chair

\n\n

\n\n\n\n\n\n\n\n\n",[145],"b20c3405-07ab-4d90-ac5c-25ace1a60c4b","README.md","1a2c8e3c-6596-11f1-ae13-1607ee4eb77e",["D",1781215819788],"# Coaster\n\n*Pull up a chair.* A Brazilian-steakhouse-style availability board for your team.\n**Green = come on over. Red = catch me later.**\n\nEach person's coaster flips **automatically** when their iPhone/Mac Focus mode turns on or off (and since Focus can follow your calendar, this gets you calendar sync without touching any work system). Everyone's status is visible at a glance on a shared dashboard.\n\n```mermaid\nflowchart LR\n on[Focus mode ON] --> a1[iPhone automation] --> red[🔴 on dashboard]\n off[Focus mode OFF] --> a2[iPhone automation] --> green[🟢 on dashboard]\n tap[Tap tile / Shortcut] --> flip[manual flip]\n```\n\n---\n\n## How this val is laid out\n\n| File | What it is |\n| --- | --- |\n| [`main.ts`](./main.ts) | The HTTP server — dashboard, `/set`, and `/api/state`. **Edit the `TEAM` list here.** |\n| [`dashboard.html`](./dashboard.html) | The board UI, served by `main.ts`. |\n| [`scriptable-widget.js`](./scriptable-widget.js) | Optional iPhone home-screen widget. |\n\n> This is already deployed on your account. Your dashboard URL is the **HTTP\n> endpoint** of `main.ts` — click the endpoint link at the top of the val to\n> get the exact `…web.val.run` address, then share it with the team.\n\n## Part 1 — Configure the team (the one required edit)\n\nIn [`main.ts`](./main.ts), edit the `TEAM` list:\n\n- one entry per person, short lowercase name (`lauren`, `sam`, …)\n- change every token to something random, e.g. `lauren: \"k9x2-mango-41\"`.\n A token is that person's lightweight password for flipping their coaster.\n\nThen privately send each teammate: the dashboard URL + *their own* token.\n\n> The board contains no names beyond first names and no work data — it's just\n> red/green dots — so it's fine on an unguessable URL.\n\n## Part 2 — Each teammate's iPhone (~5 minutes each)\n\n### A. Automatic flipping via Focus (the passive magic)\n\nDo this twice — once for Focus ON, once for Focus OFF:\n\n1. Open **Shortcuts → Automation tab → + (New Automation)**.\n2. Scroll to your Focus mode (e.g. **Do Not Disturb** or **Work**).\n3. Choose **When turning On**, and select **Run Immediately**\n (this makes it fully automatic — no confirmation tap).\n4. **New Blank Automation** → add the action **Get Contents of URL**.\n5. Set the URL to (using your own name + token):\n ```\n https://YOUR-DASHBOARD-URL/set?user=lauren&token=YOURTOKEN&status=red\n ```\n6. Done. Repeat steps 1–5 with **When turning Off** and `status=green`.\n\nNow: your Focus follows your calendar → your Focus flips your coaster →\n**your calendar effectively drives the board, with zero work-system integration.**\nThis also covers your Mac — if Focus modes are set to \"Share Across Devices\"\n(Settings → Focus), turning Focus on from the Mac triggers the iPhone automation.\n\n### B. Drive Focus from your Outlook calendar (closes the loop)\n\nFocus doesn't watch your calendar on its own — a small Shortcut does that.\nTwo pieces: get your Outlook events onto the phone, then a half-hourly check.\n\n**Step 1 — Get Outlook events into Apple Calendar.** Shortcuts can only see\ncalendars that live in the built-in Calendar app; the Outlook app keeps its\nevents siloed. In order of preference:\n\n1. **Outlook app → Settings (gear) → tap your account → \"Sync Calendars\"** —\n newer Outlook versions have this toggle, and it mirrors your work calendar\n into Apple Calendar with zero extra setup. Check here first.\n2. **Settings → Apps → Calendar → Calendar Accounts → Add Account →\n Microsoft Exchange** → sign in with your work email → enable just\n **Calendars**. (Same sanctioned access as the Outlook app itself.)\n3. **If IT blocks both:** Outlook on the web → ⚙️ → Calendar →\n **Shared calendars → Publish a calendar** → pick your calendar with\n **\"Can view when I'm busy\"** → copy the **ICS** link → iPhone Settings →\n Apps → Calendar → Calendar Accounts → **Add Subscribed Calendar** → paste.\n \"Busy\" means no titles or details leave Outlook — just blocks of time.\n Caveat: iOS refreshes subscribed calendars slowly (up to ~an hour), so\n same-day schedule changes can lag.\n\n**Step 2 — Make a \"Meeting Check\" shortcut.** New Shortcut →\n\n1. **Find Calendar Events where…** with filters:\n - **Calendar** *is* your work calendar\n - **Start Date** *is in the last* **8 hours**\n - **End Date** *is in the next* **8 hours**\n - **Is All Day** *is* **false**\n2. **If → Count → is greater than → 0**\n - inside **If**: **Set Focus → turn Work On until Turned Off**\n - inside **Otherwise**: **Set Focus → turn Work Off**\n\n(That filter combo means \"an event is happening right now\", and skips all-day\nevents so a birthday doesn't mute you for the whole day.)\n\n**Step 3 — Run it on a schedule.** Shortcuts → Automation → **+** →\n**Time of Day** → 9:00 → Daily → **Run Immediately** → action:\n**Run Shortcut → Meeting Check**. Repeat for every half-hour you take\nmeetings (9:00, 9:30, … 17:00). Tedious once, automatic forever.\n\n**Step 4 — there is no step 4.** Your Focus ON/OFF automations from section A\nalready flip the coaster, so calendar → Focus → coaster now runs end to end.\n\nTwo tips:\n\n- Point the meeting check at a dedicated **Work** Focus and keep **Do Not\n Disturb** for manual deep-work — then the half-hourly check never stomps a\n Focus you turned on yourself. Just set up the section-A automations for\n *both* Focus modes.\n- Turn on **Settings → Focus → Share Across Devices** so your Mac mutes during\n meetings too.\n\n### C. Manual flip (backup / quick toggle)\n\nPick whichever you like:\n\n- **Tap your tile on the dashboard.** First tap asks for your token once per\n device, then it's one-tap forever.\n- **A \"Flip Coaster\" Shortcut:** New Shortcut → *Get Contents of URL* →\n `...?user=lauren&token=YOURTOKEN&status=toggle`. Add it to your home screen,\n Lock Screen, or Action Button.\n\n## Part 3 — Seeing everyone at a glance\n\n- **Mac:** keep the dashboard URL open in a small pinned browser tab/window.\n It live-updates every 15 seconds.\n- **Desk signal (in-office):** prop up an old iPhone/iPad showing the dashboard\n full-screen. Add it to the home screen first (Safari → Share → **Add to Home\n Screen**) so it opens like an app with no browser chrome. Use Settings →\n Display → Auto-Lock → Never (plugged in) for an all-day desk display.\n- **iPhone home-screen widget:** see [`scriptable-widget.js`](./scriptable-widget.js)\n — shows all statuses on your home screen via the free Scriptable app.\n\n## Endpoints\n\n| Method | Path | Purpose |\n| --- | --- | --- |\n| GET | `/` | The dashboard (open on any device) |\n| GET | `/set?user=lauren&token=XXX&status=red` | Flip a coaster (`red` \\| `green` \\| `toggle`) |\n| GET | `/api/state` | All statuses as JSON (used by widgets) |\n\n## Notes & guardrails\n\n- **Stale-red safety net:** if someone's Focus-off automation ever fails to fire,\n the board automatically shows them green again after 10 hours\n (`AUTO_GREEN_AFTER_HOURS` in `main.ts` — adjust or set to 0 to disable).\n- **Changing the team:** edit the `TEAM` list in `main.ts` and save. Renames and\n new people apply instantly.\n- **It's a norm, not a lock.** Agree as a team what red means (\"ping me on Slack\n if urgent, otherwise catch me when I'm green\") — the coaster only works if\n everyone honors it, same as the steakhouse.\n- **ADHD-friendly defaults:** the automation means nobody has to *remember* to\n set or unset their status — the calendar/Focus does it. The only habit to\n build is glancing at the board before walking over.\n",[152],"pulls","forks","envVars",{"_163":54,"_165":54},"connections",{"_163":54,"_164":54},"count","unfilledCount","emptyCount",{"_20":151,"_13":152,"_120":153,"_122":-5,"_123":21,"_124":30,"_126":50,"_22":180,"_29":140,"_129":103,"_131":155,"_133":38,"_134":-5,"_171":181,"_91":182},{"_20":144,"_13":145,"_120":146,"_122":-5,"_123":21,"_124":147,"_126":50,"_22":177,"_29":128,"_129":103,"_131":149,"_133":38,"_134":-5,"_171":178,"_91":179},{"_20":136,"_13":137,"_120":48,"_122":-5,"_123":21,"_124":138,"_126":50,"_22":174,"_29":140,"_129":141,"_131":142,"_133":38,"_134":-5,"_171":175,"_91":176},{"_20":118,"_13":119,"_120":121,"_122":-5,"_123":21,"_124":125,"_126":50,"_22":170,"_29":128,"_129":130,"_131":132,"_133":38,"_134":-5,"_171":172,"_91":173},["D",1781215798347],"children",[],[119],["D",1781215711643],[],[137],["D",1781215775791],[],[145],["D",1781215819788],[],[152],["D",1781183011455],{"_11":12,"_89":85},{"_11":12,"_82":83,"_84":85,"_45":46,"_86":87,"_88":38},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_77":-5,"_78":-5,"_79":-5,"_80":14,"_81":12},"ctx",{"_70":-5,"_111":220,"_221":222,"_223":224,"_225":38,"_226":38,"_227":38,"_228":50,"_229":-5,"_230":-7,"_231":-7,"_232":54,"_233":38,"_234":38,"_235":-5,"_236":38,"_237":38,"_238":38,"_239":-5},"ENV",{"_191":192,"_193":194,"_195":26,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Branches1

Branches
1