Files
supabase/apps/www/lib
Siddhant GawadandChris Chinchilla f5d125220d docs: fix broken links in migration guide (#41469)
* docs: fix broken links in migration guide

Title
fix(docs): update broken next steps links in ssr guides

Description
Fixes #41467
Changes
Updates the "Next steps" section in the following server-side authentication guides:

apps/docs/content/guides/auth/server-side/migrating-to-ssr-from-auth-helpers.mdx

apps/docs/content/guides/auth/server-side/creating-a-client.mdx

Reason
The links in these files were pointing to deprecated "PKCE flow" pages (e.g., email-based-auth-with-pkce-flow-for-ssr) which have been removed from the documentation, resulting in 404 Not Found errors for users attempting to follow the migration or setup steps.

Solution
Remapped the broken links to the currently active, canonical documentation pages:

For migrating-to-ssr-from-auth-helpers.mdx:

Email/Password: .../email-based-auth-with-pkce-flow-for-ssr → /docs/guides/auth/passwords

OAuth: .../oauth-with-pkce-flow-for-ssr → /docs/guides/auth/social-login

SSR Overview: .../guides/auth/server-side → /docs/guides/auth/server-side-rendering

For creating-a-client.mdx:

Email/Password: .../email-based-auth-with-pkce-flow-for-ssr → /docs/guides/auth/passwords

OAuth: .../oauth-with-pkce-flow-for-ssr → /docs/guides/auth/social-login

SSR Overview: .../guides/auth/server-side-rendering → /docs/guides/auth/server-side/advanced-guide (Updated to point to the Advanced Guide to avoid circular linking, or as appropriate for the context).

Verification
Verified that the new target pages exist and cover the relevant SSR/PKCE context needed for these steps.

* fix(www): add redirects for deprecated auth ssr paths

Adds permanent redirects to handle 404 errors for deprecated PKCE flow URLs that were removed in recent updates.

Mappings added:
- /docs/guides/auth/server-side/email-based-auth-with-pkce-flow-for-ssr → /docs/guides/auth/passwords
- /docs/guides/auth/server-side/oauth-with-pkce-flow-for-ssr → /docs/guides/auth/social-login

.

* fix(docs): update broken next steps links in ssr guides

Updates the "Next steps" section in server-side auth guides to point to the correct active documentation.

Replaces broken 404 links to deprecated PKCE flow guides with links to:
- /docs/guides/auth/passwords
- /docs/guides/auth/social-login
- /docs/guides/auth/server-side-rendering

Affected files:
- apps/docs/content/guides/auth/server-side/migrating-to-ssr-from-auth-helpers.mdx
- apps/docs/content/guides/auth/server-side/creating-a-client.mdx

* fix(docs): update broken next steps links in ssr guides

Updates the "Next steps" section in server-side auth guides to point to the correct active documentation.

Replaces broken 404 links to deprecated PKCE flow guides with links to:
- /docs/guides/auth/passwords
- /docs/guides/auth/social-login
- /docs/guides/auth/server-side-rendering

Affected files:
- apps/docs/content/guides/auth/server-side/migrating-to-ssr-from-auth-helpers.mdx
- apps/docs/content/guides/auth/server-side/creating-a-client.mdx

---------

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
2026-01-13 10:28:51 +07:00
..
2025-09-03 14:49:28 +02:00
2025-12-03 11:46:39 +00:00
2024-09-17 11:07:38 +02:00
2025-09-16 13:03:13 +02:00
2025-09-05 16:57:28 -02:30
2025-11-18 18:56:11 +00:00
2025-11-18 18:56:11 +00:00
2026-01-12 10:19:08 -04:00
2025-09-05 16:57:28 -02:30
2025-10-10 17:29:40 -04:00
2025-11-13 20:02:42 +11:00
2025-09-03 14:49:28 +02:00
2023-10-13 14:07:36 -07:00
2025-10-24 11:06:31 +02:00
2025-09-03 14:49:28 +02:00
2025-09-03 14:49:28 +02:00