Remove Remix from docs by alexisintech · Pull Request #3192 · clerk/clerk-docs

alexisintech · 2026-03-06T21:06:12Z

What does this solve? What changed?

The Remix SDK has been in maintenance mode, as Remix is a no longer supported framework and defers to React Router.
This PR serves to remove Remix from the docs, and adds redirects to point users to /docs/core-2 for any Remix needs.

Deadline

No rush

+  },
+  {
+    "source": "/docs/reference/remix/root-auth-loader",
+    "destination": "/docs/core-2/remix/reference/remix/root-auth-loader"
+  },
+  {
+    "source": "/docs/reference/remix/overview",
+    "destination": "/docs/core-2/remix/reference/remix/overview"
+  },
+  {
+    "source": "/docs/reference/remix/clerk-app",
+    "destination": "/docs/core-2/remix/reference/remix/clerk-app"
+  },


@alexisintech These can be replaced with a dynamic redirect potentially:

{ "source": "/docs/reference/remix/:path*", "destination": "/docs/core-2/reference/remix/:path*", "permanent": true, }

Whether we make it a dynamic or static redirect, I don't think the destination should have "remix" twice?

E.g: "destination": "/docs/core-2/remix/reference/remix/root-auth-loader" should be "destination": "/docs/core-2/reference/remix/root-auth-loader".

#3192 (comment)

Whether we make it a dynamic or static redirect, I don't think the destination should have "remix" twice?

E.g: "destination": "/docs/core-2/remix/reference/remix/root-auth-loader" should be "destination": "/docs/core-2/reference/remix/root-auth-loader".

oh yeah can fix those ones

I would prefer we used static redirects over dynamic, but thats mainly cuz I want to simplify the redirects to only being static, getting rid of dynamic redirects all together.

redirects/static/docs.json

SarahSoutoul · 2026-03-09T17:12:10Z

@alexisintech Have reviewed & left some comments! There is sth weird happening w/ some of the redirects for sure - especially with the "clerk-app" page. For some reason, even tho the destination says reference/remix, it leads to remix/reference which is a 404. When I change it back to reference/remix in the URL manually, it leads me to the correct page.

Screen.Recording.2026-03-09.at.11.03.12.am.mov

Other than this, we'll have to make sure to have a sibling clerk PR to remove "Remix" from the SDK dropdown and a dashboard PR to remove the Remix onboarding guide. Happy to help with this if needed.

alexisintech · 2026-03-09T17:39:43Z

okay just fixed all the redirects and tested them and they're working - the only one not working is /docs/guides/development/spa-mode it's not redirecting, its just 404'ing (bc the doc is removed)

alexisintech · 2026-03-09T17:46:28Z

@alexisintech Have reviewed & left some comments! There is sth weird happening w/ some of the redirects for sure - especially with the "clerk-app" page. For some reason, even tho the destination says reference/remix, it leads to remix/reference which is a 404. When I change it back to reference/remix in the URL manually, it leads me to the correct page.

Screen.Recording.2026-03-09.at.11.03.12.am.mov
Other than this, we'll have to make sure to have a sibling clerk PR to remove "Remix" from the SDK dropdown and a dashboard PR to remove the Remix onboarding guide. Happy to help with this if needed.

@NWylynko if we remove it from clerk/clerk, will that affect core-1 and core-2 branches? if that's the case, we can probably get those to run off a specific branch of clerk/clerk 👀

SarahSoutoul · 2026-03-09T17:46:45Z

okay just fixed all the redirects and tested them and they're working - the only one not working is /docs/guides/development/spa-mode it's not redirecting, its just 404'ing (bc the doc is removed)

Hmm weird, it's working locally. But yeah not on the preview link? @NWylynko @alexisintech

Screen.Recording.2026-03-09.at.11.43.28.am.mov

Seems like we need to update the tests too to remove Remix from the failing "Test build".

NWylynko · 2026-03-09T17:51:59Z

@alexisintech Have reviewed & left some comments! There is sth weird happening w/ some of the redirects for sure - especially with the "clerk-app" page. For some reason, even tho the destination says reference/remix, it leads to remix/reference which is a 404. When I change it back to reference/remix in the URL manually, it leads me to the correct page.
Screen.Recording.2026-03-09.at.11.03.12.am.mov
Other than this, we'll have to make sure to have a sibling clerk PR to remove "Remix" from the SDK dropdown and a dashboard PR to remove the Remix onboarding guide. Happy to help with this if needed.

@NWylynko if we remove it from clerk/clerk, will that affect core-1 and core-2 branches? if that's the case, we can probably get those to run off a specific branch of clerk/clerk 👀

I think we will want to start with creating a clerk/clerk pr that removes remix from the available sdks and adds to the migration map "remix": "react-router" to migrate users over. This should also then hide all the remix content from the docs. Once thats live then we can merge this pr to solidify the removal of the remix content from the docs.

https://github.com/clerk/clerk/pull/2217 should be good

alexisintech · 2026-03-09T17:52:00Z

okay just fixed all the redirects and tested them and they're working - the only one not working is /docs/guides/development/spa-mode it's not redirecting, its just 404'ing (bc the doc is removed)

Hmm weird, it's working locally. But yeah not on the preview link? @NWylynko @alexisintech

Screen.Recording.2026-03-09.at.11.43.28.am.mov
Seems like we need to update the tests too to remove Remix from the failing "Test build".

oh it wasn't even working locally for me LOL

SarahSoutoul · 2026-03-09T18:04:10Z

oh it wasn't even working locally for me LOL

Tbh, the redirects don't seem to work for me on the previews. This might be an issue with the preview link itself potentially because locally, it works..

Screen.Recording.2026-03-09.at.11.58.31.am.mov

alexisintech · 2026-03-09T18:12:05Z

@NWylynko could you help with the tests? I'm confused on why it's failing - i simply switched remix for expo?
and looking at this test in the code, i can't figure out what's wrong

SarahSoutoul · 2026-03-09T18:38:54Z

@NWylynko could you help with the tests? I'm confused on why it's failing - i simply switched remix for expo? and looking at this test in the code, i can't figure out what's wrong - it looks correct to me

All fixed here: Fix tests. Was mostly due to places where "remix" was replaced with "react" rather than "expo", but also the output needing fixing.

alexisintech · 2026-03-09T20:48:13Z

marking as blocked until https://github.com/clerk/clerk/pull/2217 is merged

Remove Remix from docs

58ca767

alexisintech requested a review from a team as a code owner March 6, 2026 21:06

alexisintech requested review from SarahSoutoul and manovotny March 6, 2026 21:07

remove spa mode from manifest

a491c75

vercel bot had a problem deploying to Preview March 6, 2026 21:09 Failure

wobsoriano approved these changes Mar 6, 2026

View reviewed changes

skip validation for /docs/core-* destinations

8d889f8

alexisintech requested a review from NWylynko March 6, 2026 21:38

vercel bot deployed to Preview March 6, 2026 21:39 View deployment

SarahSoutoul reviewed Mar 6, 2026

View reviewed changes

SarahSoutoul self-assigned this Mar 9, 2026

SarahSoutoul reviewed Mar 9, 2026

View reviewed changes

redirects/static/docs.json Outdated Show resolved Hide resolved

fix redirects

d03bfe2

vercel bot deployed to Preview March 9, 2026 17:40 View deployment

cut remix from schemas

d607e91

vercel bot deployed to Preview March 9, 2026 17:45 View deployment

alexisintech added 2 commits March 9, 2026 11:07

replace remix with expo

1f1c2f6

lint

54c4c01

vercel bot deployed to Preview March 9, 2026 18:09 View deployment

Fix tests

7c6d145

vercel bot deployed to Preview March 9, 2026 18:37 View deployment

alexisintech added the do not merge label Mar 9, 2026

SarahSoutoul mentioned this pull request Mar 10, 2026

Remove clear remix references (part I) #3200

Merged

Merge branch 'main' into aa/cut-remix

30ac161

alexisintech removed the do not merge label Mar 12, 2026

vercel bot deployed to Preview March 12, 2026 18:35 View deployment

manovotny mentioned this pull request Mar 13, 2026

Add satellite proxy guide #3203

Merged

Conversation

alexisintech commented Mar 6, 2026 • edited by NWylynko Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this solve? What changed?

Deadline

Related

Uh oh!

vercel bot commented Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Mar 6, 2026

Uh oh!

alexisintech commented Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SarahSoutoul Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

SarahSoutoul commented Mar 9, 2026

Uh oh!

alexisintech commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Mar 9, 2026

Uh oh!

SarahSoutoul commented Mar 9, 2026

Uh oh!

NWylynko commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Mar 9, 2026

Uh oh!

SarahSoutoul commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

SarahSoutoul commented Mar 9, 2026

Uh oh!

alexisintech commented Mar 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

alexisintech commented Mar 6, 2026 •

edited by NWylynko

Loading

vercel bot commented Mar 6, 2026 •

edited

Loading

alexisintech commented Mar 6, 2026 •

edited

Loading

SarahSoutoul Mar 9, 2026 •

edited

Loading

alexisintech commented Mar 9, 2026 •

edited

Loading

NWylynko commented Mar 9, 2026 •

edited

Loading

SarahSoutoul commented Mar 9, 2026 •

edited

Loading

alexisintech commented Mar 9, 2026 •

edited

Loading