Skip to content

docs(env): .env.example pointed at a dashboard we retired - #807

Merged
catomean merged 1 commit into
mainfrom
chore/env-example-selfhost
Aug 28, 2026
Merged

docs(env): .env.example pointed at a dashboard we retired#807
catomean merged 1 commit into
mainfrom
chore/env-example-selfhost

Conversation

@catomean

Copy link
Copy Markdown
Collaborator

The managed Supabase Cloud project was decommissioned in 2026-06. This repo already documents that — docs/operations/DECOMMISSION-CLOUD.md is the runbook, and next.config.js marks the retired host in a comment. But .env.example still opened with

# Get from: https://supabase.com/dashboard/project/[project]/settings/api
NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"

That is the first file anyone opens when setting the app up, and it sends them to a control plane we do not have.

Not cosmetic. The same shape took botsmann down: its setup doc described a hosted project in the present tense, so its eleven migrations were never applied and /api/health served PGRST205 for months while every deploy went green (bitbaum/botsmann#143). A wrong pointer to a real-looking place is worse than no pointer — no pointer makes someone ask, a plausible one makes them assume it was handled.

Now points at https://supabase.orangecat.ch, says the keys live in the box .env, and links the decommission runbook for the history.

Found by a fleet-wide sweep for hosted-Supabase references. This was the last live instruction left in the fleet — printcraft's was deleted in bitbaum/printcraft#30, and bitbaum/fleet#4 adds the audit that keeps it that way. The runbook, the CLAUDE.md warning and the next.config.js comment stay exactly as they are: they are records of leaving, and the audit's baseline names them with a reason.

npm run verify green (all 15 gates); pre-commit and pre-push hooks green.

The managed Supabase Cloud project was decommissioned in 2026-06 — this repo
documents that in docs/operations/DECOMMISSION-CLOUD.md and marks the retired
host in next.config.js. But .env.example still opened with

  # Get from: https://supabase.com/dashboard/project/[project]/settings/api

and gave the URL as a hosted placeholder. That is the first file anyone opens
when setting the app up, and it sends them to a control plane we do not have.

Not a cosmetic fix. The same shape took botsmann down: its setup doc described
a hosted project in the present tense, so its eleven migrations were never
applied and /api/health served PGRST205 for months while every deploy went
green (bitbaum/botsmann#143). A wrong pointer to a real-looking place is worse
than no pointer — no pointer makes someone ask, a plausible one makes them
assume it was handled.

Found by a fleet-wide sweep for hosted-Supabase references; this was the last
live instruction left in the fleet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018waGt1ieA9TjpscqrbrnGb
@catomean
catomean merged commit 9d2624a into main Aug 28, 2026
5 checks passed
@catomean
catomean deleted the chore/env-example-selfhost branch August 28, 2026 09:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant