From d29c8e0658f2f411e7d934a9a25118dfa65edd68 Mon Sep 17 00:00:00 2001 From: TurtleWolfe Date: Tue, 12 May 2026 21:07:55 +0000 Subject: [PATCH] docs(auth): #85 replace stale Supabase project ref with placeholder MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Supabase project the repo currently points at is huvitqubafsrazpjxsax, but docs/AUTH-SETUP.md and three other docs files still referenced an older project ref (vswxgxbjodpgwfgsjrhq, 28 instances in AUTH-SETUP.md alone) across dashboard URLs, OAuth callback URIs, and env-var examples. Stale refs in fork-onboarding docs are worse than just inaccurate: - A fresh forker who follows AUTH-SETUP.md verbatim ends up on someone else's Supabase dashboard URL (404 or "access denied"), not their own. - Every Supabase project rotation in this repo's history would have required a doc-wide ref swap (it didn't happen the last time, hence this issue). Replaced all owner-specific refs with placeholders. Matches the existing YOUR_PROJECT_REF convention already used at docs/prp-docs/archive/completed/payment-integration-prp.md:443. Files touched (32 refs total across 5 files): - docs/AUTH-SETUP.md (28 refs, including 5 OAuth callback URLs that GitHub/Google must accept for the fix in issue #85 to even land) - docs/specs/016-user-authentication/quickstart.md (1 ref, env example) - docs/specs/016-user-authentication/contracts/auth-api.yaml (1 ref, OpenAPI server URL) - docs/specs/016-user-authentication/contracts/profile-api.yaml (1 ref, OpenAPI server URL) - docs/features/payment-integration.md (1 ref, example "Project ID" format placeholder — replaced with generic abcdefghi… since the surrounding text reads "alphanumeric code like ..." and a literal placeholder would have read awkwardly) Deliberately not touched: - docs/specs/023-user-messaging-system/IMPLEMENTATION-STATUS.md:119 contains a stale ref inside a captured error trace. Rewriting it would falsify the historical incident record. Left as-is. Verification: grep -rn "vswxgxbjodpgwfgsjrhq\|huvitqubafsrazpjxsax" docs/ → only the one IMPLEMENTATION-STATUS.md hit remains (by design) Scope: This PR handles only the in-repo doc cleanup half of #85. The other half (repairing the Supabase project's OAuth provider config — Client IDs are currently literal "placeholder_*" strings, confirmed via Management API) is external to the repo and requires Supabase dashboard access. That work is in flight and will close #85 once smoke-tested. Refs: #85 Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/AUTH-SETUP.md | 56 +++++++++---------- docs/features/payment-integration.md | 2 +- .../contracts/auth-api.yaml | 2 +- .../contracts/profile-api.yaml | 2 +- .../016-user-authentication/quickstart.md | 2 +- 5 files changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/AUTH-SETUP.md b/docs/AUTH-SETUP.md index bbe2ad9c..565748d1 100644 --- a/docs/AUTH-SETUP.md +++ b/docs/AUTH-SETUP.md @@ -4,7 +4,7 @@ Complete guide for configuring Supabase authentication with email/password and O ## Prerequisites -- Supabase project created: `vswxgxbjodpgwfgsjrhq` +- Supabase project created — substitute its ref for `` in the URLs below - Environment variables configured in `.env.local` ## Part 1: Database Setup @@ -13,7 +13,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Supabase SQL Editor -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/sql +- **URL:** https://supabase.com/dashboard/project//sql **Step 2:** Drop all existing tables (clean slate) @@ -33,7 +33,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 4:** Verify tables were created -- Navigate to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/editor +- Navigate to: https://supabase.com/dashboard/project//editor - You should see these tables: - `payment_intents` ← Payment system - `payment_results` ← Payment system @@ -51,7 +51,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Auth Providers -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/providers +- **URL:** https://supabase.com/dashboard/project//auth/providers **Step 2:** Find "Email" in the provider list @@ -76,7 +76,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Email Templates -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/templates +- **URL:** https://supabase.com/dashboard/project//auth/templates **Step 2:** Customize templates @@ -104,7 +104,7 @@ Complete guide for configuring Supabase authentication with email/password and O | **Application name** | `ScriptHammer` (or your preferred name) | | **Homepage URL** | `http://localhost:3000` (development) or your production URL | | **Application description** | (Optional) "Next.js template with authentication" | -| **Authorization callback URL** | `https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1/callback` | +| **Authorization callback URL** | `https://.supabase.co/auth/v1/callback` | **Step 3:** Register application @@ -121,7 +121,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Auth Providers -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/providers +- **URL:** https://supabase.com/dashboard/project//auth/providers **Step 2:** Find and enable GitHub @@ -141,7 +141,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 5:** Verify callback URL matches - Ensure the callback URL in Supabase matches what you entered in GitHub: - - `https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1/callback` + - `https://.supabase.co/auth/v1/callback` ## Part 4: Enable Google OAuth (Optional) @@ -173,7 +173,7 @@ Complete guide for configuring Supabase authentication with email/password and O - **Application type:** Web application - **Name:** ScriptHammer - **Authorized redirect URIs:** Click **"+ ADD URI"** - - Add: `https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1/callback` + - Add: `https://.supabase.co/auth/v1/callback` - Click **"CREATE"** **Step 5:** Copy credentials @@ -185,7 +185,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Auth Providers -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/providers +- **URL:** https://supabase.com/dashboard/project//auth/providers **Step 2:** Find and enable Google @@ -208,7 +208,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Auth settings -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/url-configuration +- **URL:** https://supabase.com/dashboard/project//auth/url-configuration **Step 2:** Set Site URL @@ -225,7 +225,7 @@ Complete guide for configuring Supabase authentication with email/password and O **Step 1:** Navigate to Auth settings -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/settings/auth +- **URL:** https://supabase.com/dashboard/project//settings/auth **Step 2:** Configure security settings @@ -269,7 +269,7 @@ docker compose exec scripthammer pnpm run dev **Step 5:** Verify user was created -- Navigate to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/users +- Navigate to: https://supabase.com/dashboard/project//auth/users - You should see `test@example.com` in the user list ### 6.2 Test OAuth Sign-In (GitHub/Google) @@ -294,7 +294,7 @@ docker compose exec scripthammer pnpm run dev **Step 5:** Check Supabase users -- Navigate to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/users +- Navigate to: https://supabase.com/dashboard/project//auth/users - You should see your GitHub/Google account in the user list ## Part 7: Environment Variables @@ -305,17 +305,17 @@ Create or update `.env.local` in project root: ```bash # Supabase Configuration -NEXT_PUBLIC_SUPABASE_URL=https://vswxgxbjodpgwfgsjrhq.supabase.co +NEXT_PUBLIC_SUPABASE_URL=https://.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key_here -# Get anon key from: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/settings/api +# Get anon key from: https://supabase.com/dashboard/project//settings/api ``` ### 7.2 Get Supabase API Keys **Step 1:** Navigate to API settings -- **URL:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/settings/api +- **URL:** https://supabase.com/dashboard/project//settings/api **Step 2:** Copy API keys @@ -336,7 +336,7 @@ docker compose exec scripthammer pnpm run dev **Solution:** Email/GitHub/Google provider not enabled in Supabase -- Go to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/providers +- Go to: https://supabase.com/dashboard/project//auth/providers - Enable the provider you're trying to use - Click **"Save"** @@ -344,7 +344,7 @@ docker compose exec scripthammer pnpm run dev **Solution:** Redirect URL not whitelisted -- Go to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/url-configuration +- Go to: https://supabase.com/dashboard/project//auth/url-configuration - Add your URL to **"Redirect URLs"** - Format: `http://localhost:3000/**` (note the `/**` wildcard) @@ -354,7 +354,7 @@ docker compose exec scripthammer pnpm run dev - Check email inbox for verification link - Or disable email confirmation temporarily: - - Go to: https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/settings/auth + - Go to: https://supabase.com/dashboard/project//settings/auth - Toggle **"Enable email confirmations"** to OFF (not recommended for production) ### Issue: GitHub OAuth callback error @@ -362,7 +362,7 @@ docker compose exec scripthammer pnpm run dev **Solution:** Callback URL mismatch - Verify GitHub OAuth app callback URL matches: - - `https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1/callback` + - `https://.supabase.co/auth/v1/callback` - Check both GitHub app settings and Supabase provider settings ### Issue: Google OAuth "redirect_uri_mismatch" @@ -372,18 +372,18 @@ docker compose exec scripthammer pnpm run dev - Go to: https://console.cloud.google.com/apis/credentials - Edit your OAuth 2.0 Client ID - Add authorized redirect URI: - - `https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1/callback` + - `https://.supabase.co/auth/v1/callback` ## Reference Links ### Supabase Dashboard -- **Project Home:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq -- **SQL Editor:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/sql -- **Auth Providers:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/providers -- **Auth Users:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/users -- **API Settings:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/settings/api -- **URL Configuration:** https://supabase.com/dashboard/project/vswxgxbjodpgwfgsjrhq/auth/url-configuration +- **Project Home:** https://supabase.com/dashboard/project/ +- **SQL Editor:** https://supabase.com/dashboard/project//sql +- **Auth Providers:** https://supabase.com/dashboard/project//auth/providers +- **Auth Users:** https://supabase.com/dashboard/project//auth/users +- **API Settings:** https://supabase.com/dashboard/project//settings/api +- **URL Configuration:** https://supabase.com/dashboard/project//auth/url-configuration ### OAuth Provider Setup diff --git a/docs/features/payment-integration.md b/docs/features/payment-integration.md index 964deefb..af8dfbe7 100644 --- a/docs/features/payment-integration.md +++ b/docs/features/payment-integration.md @@ -55,7 +55,7 @@ This guide walks you through setting up the complete payment integration system **Get the Project ID:** 7. In the left Settings sidebar, click **General** -8. Copy **Project ID** (alphanumeric code like `vswxgxbjodpgwfgsjrhq`) +8. Copy **Project ID** (alphanumeric code like `abcdefghijklmnopqrst`) **Database Password:** diff --git a/docs/specs/016-user-authentication/contracts/auth-api.yaml b/docs/specs/016-user-authentication/contracts/auth-api.yaml index 68a07f66..33c5cf18 100644 --- a/docs/specs/016-user-authentication/contracts/auth-api.yaml +++ b/docs/specs/016-user-authentication/contracts/auth-api.yaml @@ -5,7 +5,7 @@ info: description: API contracts for authentication endpoints (Supabase Auth) servers: - - url: https://vswxgxbjodpgwfgsjrhq.supabase.co/auth/v1 + - url: https://.supabase.co/auth/v1 description: Supabase Auth Server paths: diff --git a/docs/specs/016-user-authentication/contracts/profile-api.yaml b/docs/specs/016-user-authentication/contracts/profile-api.yaml index 5cf065b1..8427b028 100644 --- a/docs/specs/016-user-authentication/contracts/profile-api.yaml +++ b/docs/specs/016-user-authentication/contracts/profile-api.yaml @@ -5,7 +5,7 @@ info: description: API contracts for user profile management servers: - - url: https://vswxgxbjodpgwfgsjrhq.supabase.co/rest/v1 + - url: https://.supabase.co/rest/v1 description: Supabase REST API paths: diff --git a/docs/specs/016-user-authentication/quickstart.md b/docs/specs/016-user-authentication/quickstart.md index 2caa12d7..bd4ca57f 100644 --- a/docs/specs/016-user-authentication/quickstart.md +++ b/docs/specs/016-user-authentication/quickstart.md @@ -12,7 +12,7 @@ cp .env.example .env # Add Supabase credentials - NEXT_PUBLIC_SUPABASE_URL=https://vswxgxbjodpgwfgsjrhq.supabase.co + NEXT_PUBLIC_SUPABASE_URL=https://.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY= ```