[PR #6577] [MERGED] docs: add WorkOS migration guide #32358

Closed
opened 2026-04-17 23:11:38 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/6577
Author: @bytaesu
Created: 12/7/2025
Status: Merged
Merged: 12/8/2025
Merged by: @Bekacru

Base: canaryHead: 2025-12-06/docs/workos-migration-guide


📝 Commits (10+)

  • 02abab4 adjust sidebar guide section
  • 2521c93 add WorkOS migration guide section
  • 851f6bf add WorkOS migration guide content
  • 26ddf3d update WorkOS migration guide
  • f55a9a2 Merge branch 'canary' into 2025-12-06/docs/workos-migration-guide
  • db42ef2 Merge branch 'canary' into 2025-12-06/docs/workos-migration-guide
  • 51ebdc8 content minor tweaks
  • 95f44e7 chore: add custom words to spell checker
  • 3e4c940 add enterprise link into content
  • 8ae4221 adjust wrapping up section

📊 Changes

5 files changed (+822 additions, -79 deletions)

View changed files

📝 .cspell/custom-words.txt (+2 -1)
📝 .cspell/third-party.txt (+2 -1)
📝 docs/app/enterprise/_components/enterprise-hero.tsx (+3 -1)
📝 docs/components/sidebar-content.tsx (+103 -76)
docs/content/docs/guides/workos-migration-guide.mdx (+712 -0)

📄 Description

  • Added new migration guide (WorkOS -> Better Auth)
  • Adjusted the sidebar guide section UI to make it cleaner, since there were multiple migration guides.

Summary by cubic

Added a WorkOS → Better Auth migration guide and cleaned up the docs sidebar by grouping migration guides for easier navigation. This helps WorkOS users transition smoothly and makes related guides easier to find.

  • New Features

    • Comprehensive WorkOS migration guide with feature mapping, schema generation, and Next.js examples.
    • Included a rate‑limited user migration script using the WorkOS API.
    • Clear considerations for passwords, data syncing, downtime, and sessions.
  • Refactors

    • Grouped all migration guides under a new “Migration” section in the sidebar.
    • Added the WorkOS guide link and adjusted iconography and ordering for a cleaner guide section.

Written for commit 821854723b. Summary will update automatically on new commits.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/better-auth/better-auth/pull/6577 **Author:** [@bytaesu](https://github.com/bytaesu) **Created:** 12/7/2025 **Status:** ✅ Merged **Merged:** 12/8/2025 **Merged by:** [@Bekacru](https://github.com/Bekacru) **Base:** `canary` ← **Head:** `2025-12-06/docs/workos-migration-guide` --- ### 📝 Commits (10+) - [`02abab4`](https://github.com/better-auth/better-auth/commit/02abab46b41f85c9ea3f318cc5d64e13ad4f14fe) adjust sidebar guide section - [`2521c93`](https://github.com/better-auth/better-auth/commit/2521c93d55afb289ebe898ad4e0807002286ffda) add WorkOS migration guide section - [`851f6bf`](https://github.com/better-auth/better-auth/commit/851f6bf1c248b414d4cd4b0ee2da5277d688c245) add WorkOS migration guide content - [`26ddf3d`](https://github.com/better-auth/better-auth/commit/26ddf3ddf20f781905f4db2698e8d56ad2592d60) update WorkOS migration guide - [`f55a9a2`](https://github.com/better-auth/better-auth/commit/f55a9a2952b920ed380de8dc287abbfdf4c4e9bf) Merge branch 'canary' into 2025-12-06/docs/workos-migration-guide - [`db42ef2`](https://github.com/better-auth/better-auth/commit/db42ef21916dc2e8b1009d5d2710dc4bc9797ef0) Merge branch 'canary' into 2025-12-06/docs/workos-migration-guide - [`51ebdc8`](https://github.com/better-auth/better-auth/commit/51ebdc887f7fe6d29b65c49ceb250e500d8207c8) content minor tweaks - [`95f44e7`](https://github.com/better-auth/better-auth/commit/95f44e76b24bf73cb14bd60195e2c1fe35e3b611) chore: add custom words to spell checker - [`3e4c940`](https://github.com/better-auth/better-auth/commit/3e4c940545ba26a0cd4f6d0aa5f7018a34940026) add enterprise link into content - [`8ae4221`](https://github.com/better-auth/better-auth/commit/8ae4221fde6ab4804958597667619835e3f907a8) adjust wrapping up section ### 📊 Changes **5 files changed** (+822 additions, -79 deletions) <details> <summary>View changed files</summary> 📝 `.cspell/custom-words.txt` (+2 -1) 📝 `.cspell/third-party.txt` (+2 -1) 📝 `docs/app/enterprise/_components/enterprise-hero.tsx` (+3 -1) 📝 `docs/components/sidebar-content.tsx` (+103 -76) ➕ `docs/content/docs/guides/workos-migration-guide.mdx` (+712 -0) </details> ### 📄 Description - Added new migration guide (WorkOS -> Better Auth) - Adjusted the sidebar guide section UI to make it cleaner, since there were multiple migration guides. <!-- This is an auto-generated description by cubic. --> --- ## Summary by cubic Added a WorkOS → Better Auth migration guide and cleaned up the docs sidebar by grouping migration guides for easier navigation. This helps WorkOS users transition smoothly and makes related guides easier to find. - **New Features** - Comprehensive WorkOS migration guide with feature mapping, schema generation, and Next.js examples. - Included a rate‑limited user migration script using the WorkOS API. - Clear considerations for passwords, data syncing, downtime, and sessions. - **Refactors** - Grouped all migration guides under a new “Migration” section in the sidebar. - Added the WorkOS guide link and adjusted iconography and ordering for a cleaner guide section. <sup>Written for commit 821854723b63106f807da61a71c3d3c6696365f9. Summary will update automatically on new commits.</sup> <!-- End of auto-generated description by cubic. --> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-04-17 23:11:38 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#32358