[PR #584] [MERGED] feat: add next-auth migration guide #11629

Closed
opened 2026-04-13 07:54:21 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/584
Author: @MohammedIbrahim8887
Created: 11/18/2024
Status: Merged
Merged: 11/19/2024
Merged by: @Bekacru

Base: v1.0Head: feat/next-auth-migration-guide


📝 Commits (5)

  • 731f89a feat: add next-auth migration guide
  • 9f7bb94 Merge branch 'main' into docs/next-auth-guide
  • 4176f31 wip
  • 84fce3e Merge branch 'v1.0' into docs/next-auth-guide
  • 4197bd7 docs: improve migration guide

📊 Changes

5 files changed (+1049 additions, -708 deletions)

View changed files

📝 .vscode/settings.json (+1 -1)
📝 CONTRIBUTING.md (+5 -3)
📝 docs/components/sidebar-content.tsx (+860 -703)
docs/content/docs/guides/next-auth-migration-guide.mdx (+174 -0)
📝 packages/better-auth/src/db/schema.ts (+9 -1)

📄 Description

PR Summary

Overview

This pull request introduces the following changes:

  • Updates the CONTRIBUTING.md guide to improve clarity and add new steps for project setup and contribution.
  • Adds a comprehensive guide for migrating from NextAuth to BetterAuth, including detailed steps for integration, schema updates, and frontend adjustments.

Changes

CONTRIBUTING.md

5 additions, 3 deletions

  • Improved the readability and formatting of steps for contributors:
    • Corrected a duplicate step for running pnpm i.
    • Added instructions for building the project (pnpm build) and running the documentation (pnpm -F docs dev).
    • Reordered steps for better clarity.

New File: docs/content/docs/guides/next-auth.mdx

  • A detailed step-by-step guide to migrate a project from NextAuth to BetterAuth:
    • Introduced the BetterAuth library and its core functionality.
    • Provided instructions for:
      • Setting up the auth.ts file.
      • Generating a new schema with BetterAuth CLI.
      • Mapping database columns for compatibility.
      • Adding route listeners and configuring tRPC sessions.
      • Creating and integrating frontend authentication components (e.g., SignInButton).
    • Included best practices to avoid common errors (e.g., hydration issues).
    • Linked additional resources and example implementations.

docs/components/sidebar-content.tsx

  • Added links for

Impact

  • Enhances contributor experience by streamlining the contribution process.
  • Provides a robust guide for developers looking to upgrade their authentication workflow with BetterAuth.
  • Ensures seamless integration with existing projects using tools like Prisma, Postgres, and the T3 stack.

PR Generated message with Pr-Buddy


🔄 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/584 **Author:** [@MohammedIbrahim8887](https://github.com/MohammedIbrahim8887) **Created:** 11/18/2024 **Status:** ✅ Merged **Merged:** 11/19/2024 **Merged by:** [@Bekacru](https://github.com/Bekacru) **Base:** `v1.0` ← **Head:** `feat/next-auth-migration-guide` --- ### 📝 Commits (5) - [`731f89a`](https://github.com/better-auth/better-auth/commit/731f89aa62f57d19eb5a4aac349cb334cccb04d3) feat: add next-auth migration guide - [`9f7bb94`](https://github.com/better-auth/better-auth/commit/9f7bb943bd109497a8c3d3318ddfae5651c39f32) Merge branch 'main' into docs/next-auth-guide - [`4176f31`](https://github.com/better-auth/better-auth/commit/4176f3130880d86ffed5d6a596d6b802de65294a) wip - [`84fce3e`](https://github.com/better-auth/better-auth/commit/84fce3e5e59f17ee2f4c6a3547f099e6a661653a) Merge branch 'v1.0' into docs/next-auth-guide - [`4197bd7`](https://github.com/better-auth/better-auth/commit/4197bd77ff4cf1dc6217defb7eac23020d6a6084) docs: improve migration guide ### 📊 Changes **5 files changed** (+1049 additions, -708 deletions) <details> <summary>View changed files</summary> 📝 `.vscode/settings.json` (+1 -1) 📝 `CONTRIBUTING.md` (+5 -3) 📝 `docs/components/sidebar-content.tsx` (+860 -703) ➕ `docs/content/docs/guides/next-auth-migration-guide.mdx` (+174 -0) 📝 `packages/better-auth/src/db/schema.ts` (+9 -1) </details> ### 📄 Description # PR Summary ## Overview This pull request introduces the following changes: - Updates the `CONTRIBUTING.md` guide to improve clarity and add new steps for project setup and contribution. - Adds a comprehensive guide for migrating from NextAuth to BetterAuth, including detailed steps for integration, schema updates, and frontend adjustments. ## Changes ### `CONTRIBUTING.md` **5 additions, 3 deletions** - Improved the readability and formatting of steps for contributors: - Corrected a duplicate step for running `pnpm i`. - Added instructions for building the project (`pnpm build`) and running the documentation (`pnpm -F docs dev`). - Reordered steps for better clarity. ### New File: `docs/content/docs/guides/next-auth.mdx` - A detailed step-by-step guide to migrate a project from NextAuth to BetterAuth: - Introduced the BetterAuth library and its core functionality. - Provided instructions for: - Setting up the `auth.ts` file. - Generating a new schema with BetterAuth CLI. - Mapping database columns for compatibility. - Adding route listeners and configuring tRPC sessions. - Creating and integrating frontend authentication components (e.g., `SignInButton`). - Included best practices to avoid common errors (e.g., hydration issues). - Linked additional resources and example implementations. ### `docs/components/sidebar-content.tsx` - Added links for ## Impact - Enhances contributor experience by streamlining the contribution process. - Provides a robust guide for developers looking to upgrade their authentication workflow with BetterAuth. - Ensures seamless integration with existing projects using tools like Prisma, Postgres, and the T3 stack. PR Generated message with Pr-Buddy✨✨ --- <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-13 07:54:21 -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#11629