diff --git a/.changeset/upset-worlds-like.md b/.changeset/upset-worlds-like.md
new file mode 100644
index 0000000000..0ebc4431f1
--- /dev/null
+++ b/.changeset/upset-worlds-like.md
@@ -0,0 +1,5 @@
+---
+"better-auth": patch
+---
+
+fix: improve link accessibility issues
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 56ff32d676..2ca55ebf57 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -5,7 +5,7 @@ body:
- type: checkboxes
attributes:
label: Is this suited for github?
- description: Feel free to join the discord community [here](https://discord.gg/better-auth), we can usually respond faster to any questions.
+ description: Feel free to [join the discord community](https://discord.gg/better-auth), we can usually respond faster to any questions.
options:
- label: Yes, this is suited for github
- type: markdown
@@ -13,8 +13,8 @@ body:
value: |
Thank you for reporting a bug with better-auth!
- - Feature requests should be opened [here](https://github.com/better-auth/better-auth/issues/new?template=feature_request.yml).
- - Before opening a new issue, please [check](https://github.com/better-auth/better-auth/issues) for existing issues and :+1: upvote the existing issue instead. This will result in a quicker resolution.
+ - If you have a feature request, please use the [feature request form](https://github.com/better-auth/better-auth/issues/new?template=feature_request.yml) instead.
+ - Before opening a new issue, please check for [existing issues](https://github.com/better-auth/better-auth/issues) and :+1: upvote the existing issue instead. This will result in a quicker resolution.
- type: textarea
attributes:
label: Reproduction
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index 20df6e60ec..30689c3d07 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -5,7 +5,7 @@ body:
- type: checkboxes
attributes:
label: Is this suited for github?
- description: Feel free to join the discord community [here](https://discord.gg/better-auth), we can usually respond faster to any questions.
+ description: Feel free to [join the discord community](https://discord.gg/better-auth), we can usually respond faster to any questions.
options:
- label: Yes, this is suited for github
- type: markdown
@@ -13,8 +13,8 @@ body:
value: |
Thank you for suggesting a feature with better-auth!
- - Bug reports should be opened [here](https://github.com/better-auth/better-auth/issues/new?template=bug_report.yml).
- - Before opening a feature request, please [check](https://github.com/better-auth/better-auth/issues) for existing issues and :+1: upvote the existing request instead. This will result in a quicker resolution.
+ - If you have a bug report, please use the [bug report form](https://github.com/better-auth/better-auth/issues/new?template=bug_report.yml) instead.
+ - Before opening a feature request, please check for [existing issues](https://github.com/better-auth/better-auth/issues) and :+1: upvote the existing request instead. This will result in a quicker resolution.
- type: textarea
attributes:
label: Is your feature request related to a problem? Please describe.
diff --git a/docs/content/blogs/0-supabase-auth-to-planetscale-migration.mdx b/docs/content/blogs/0-supabase-auth-to-planetscale-migration.mdx
index 0b14868381..4b1c5cea87 100644
--- a/docs/content/blogs/0-supabase-auth-to-planetscale-migration.mdx
+++ b/docs/content/blogs/0-supabase-auth-to-planetscale-migration.mdx
@@ -63,8 +63,7 @@ We’ve noticed that some users are migrating from Supabase to PlanetScale Postg
- Follow and complete the basic setup
- [here](https://www.better-auth.com/docs/installation)
+ Follow and complete the [basic setup](https://www.better-auth.com/docs/installation)
@@ -342,7 +341,7 @@ You've successfully migrated from Supabase Auth to Better Auth on PlanetScale.
* Double-check that all environment variables are set in production.
* Test all auth flows (sign-up, login, password reset, session refresh) before going live.
-* Remember that this is just the basics and if you've integrated Supabase Auth's auth functions in a lot of placed you'd have to find the suitable Better Auth replacements [here](https://www.better-auth.com/docs).
+* Remember that this is just the basics and if you've integrated Supabase Auth's auth functions in a lot of placed you'd have to find the suitable [Better Auth replacements](https://www.better-auth.com/docs).
* Have fun!
### Learn More!
diff --git a/docs/content/docs/adapters/other-relational-databases.mdx b/docs/content/docs/adapters/other-relational-databases.mdx
index bead3c4fc9..b3012b1815 100644
--- a/docs/content/docs/adapters/other-relational-databases.mdx
+++ b/docs/content/docs/adapters/other-relational-databases.mdx
@@ -41,6 +41,5 @@ Any dialect supported by Kysely can be utilized with Better Auth, including capa
* [PGLite](https://github.com/czeidler/kysely-pglite-dialect)
- You can see the full list of supported Kysely dialects{" "}
- here.
+ You can see the full list of supported Kysely dialects.
diff --git a/docs/content/docs/adapters/prisma.mdx b/docs/content/docs/adapters/prisma.mdx
index ad48f5e85a..c5fb942939 100644
--- a/docs/content/docs/adapters/prisma.mdx
+++ b/docs/content/docs/adapters/prisma.mdx
@@ -34,7 +34,7 @@ export const auth = betterAuth({
```
- Starting from Prisma 7, the `output` path field is required. If you have configured a custom output path in your `schema.prisma` file (e.g., `output = "../src/generated/prisma"`), make sure to import the Prisma client from that location instead of `@prisma/client`. For more information, see [here](https://www.prisma.io/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client#the-location-of-prisma-client).
+ Starting from Prisma 7, the `output` path field is required. If you have configured a custom output path in your `schema.prisma` file (e.g., `output = "../src/generated/prisma"`), make sure to [import the Prisma client from that location](https://www.prisma.io/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client#the-location-of-prisma-client) instead of `@prisma/client`.
## Schema generation & migration
diff --git a/docs/content/docs/guides/clerk-migration-guide.mdx b/docs/content/docs/guides/clerk-migration-guide.mdx
index d8ef4f7a51..1e6ef99a30 100644
--- a/docs/content/docs/guides/clerk-migration-guide.mdx
+++ b/docs/content/docs/guides/clerk-migration-guide.mdx
@@ -165,7 +165,7 @@ Before starting the migration process, set up Better Auth in your project. Follo
### Export Clerk Users
- Go to the Clerk dashboard and export the users. Check how to do it [here](https://clerk.com/docs/deployments/exporting-users#export-your-users-data-from-the-clerk-dashboard). It will download a CSV file with the users data. You need to save it as `exported_users.csv` and put it in the root of your project.
+ Go to the Clerk dashboard and [export the users](https://clerk.com/docs/deployments/exporting-users#export-your-users-data-from-the-clerk-dashboard). It will download a CSV file with the users data. You need to save it as `exported_users.csv` and put it in the root of your project.
diff --git a/docs/content/docs/guides/optimizing-for-performance.mdx b/docs/content/docs/guides/optimizing-for-performance.mdx
index 7e0e7a8dbc..d3ee57e436 100644
--- a/docs/content/docs/guides/optimizing-for-performance.mdx
+++ b/docs/content/docs/guides/optimizing-for-performance.mdx
@@ -46,7 +46,7 @@ Here are examples of how you can do caching in different frameworks and environm
}
```
- Learn more about NextJS use cache directive here.
+ Learn more about NextJS use cache directive.
@@ -82,7 +82,7 @@ Here are examples of how you can do caching in different frameworks and environm
);
```
- Learn more about SolidStart `query` function here.
+ Learn more about SolidStart `query` function.
@@ -113,7 +113,7 @@ Here are examples of how you can do caching in different frameworks and environm
}
```
- Learn more about TanStack Query here.
+ Learn more about TanStack Query.
diff --git a/docs/content/docs/guides/workos-migration-guide.mdx b/docs/content/docs/guides/workos-migration-guide.mdx
index f76739b938..63225b7ebe 100644
--- a/docs/content/docs/guides/workos-migration-guide.mdx
+++ b/docs/content/docs/guides/workos-migration-guide.mdx
@@ -709,4 +709,4 @@ Existing active sessions will not be migrated. After the migration, users will n
Congratulations! You've successfully migrated from WorkOS to Better Auth. Better Auth offers greater flexibility and more features, so be sure to explore the [documentation](/docs) to unlock its full potential.
-If you need help with migration, join our [community](/community) or reach out for Enterprise support [here](/enterprise).
+If you need help with migration, join our [community](/community) or reach out for [Enterprise support](/enterprise).
diff --git a/docs/content/docs/integrations/convex.mdx b/docs/content/docs/integrations/convex.mdx
index a0d7182782..f5c6890afe 100644
--- a/docs/content/docs/integrations/convex.mdx
+++ b/docs/content/docs/integrations/convex.mdx
@@ -40,7 +40,7 @@ In this guide, we'll walk through the steps to integrate Better Auth with [Conve
```
- `@convex-dev/better-auth` is maintained by Convex. For issues or more details, please visit [here](https://github.com/get-convex/better-auth).
+ [`@convex-dev/better-auth`](https://github.com/get-convex/better-auth) is maintained by Convex.
@@ -114,7 +114,7 @@ In this guide, we'll walk through the steps to integrate Better Auth with [Conve
## Create the Better Auth Convex Component
- Convex components can be installed from NPM or a local folder. While the NPM version is available [here](https://labs.convex.dev/better-auth), this guide uses a local folder setup to unlock the full potential of Better Auth.
+ Convex components can be installed from NPM or a local folder. While the [NPM version](https://labs.convex.dev/better-auth) is available, this guide uses a local folder setup to unlock the full potential of Better Auth.
### Create the component definition
diff --git a/docs/content/docs/integrations/expo.mdx b/docs/content/docs/integrations/expo.mdx
index 1ad4a78aa7..7cf39f18a3 100644
--- a/docs/content/docs/integrations/expo.mdx
+++ b/docs/content/docs/integrations/expo.mdx
@@ -17,7 +17,7 @@ Expo is a popular framework for building cross-platform apps with React Native.
Before using Better Auth with Expo, make sure you have a Better Auth backend set up. You can either use a separate server or leverage Expo's new [API Routes](https://docs.expo.dev/router/reference/api-routes) feature to host your Better Auth instance.
- To get started, check out our [installation](/docs/installation) guide for setting up Better Auth on your server. If you prefer to check out the full example, you can find it [here](https://github.com/better-auth/examples/tree/main/expo-example).
+ To get started, check out our [installation](/docs/installation) guide for setting up Better Auth on your server. If you prefer, check out the [full example](https://github.com/better-auth/examples/tree/main/expo-example).
To use the new API routes feature in Expo to host your Better Auth instance you can create a new API route in your Expo app and mount the Better Auth handler.
@@ -330,7 +330,7 @@ export default function SocialSignIn() {
```
- On native (iOS/Android), `signIn.social` does not navigate automatically. Handle navigation yourself after it resolves. Note that the underlying browser behavior differs by platform. For more information, see [here](https://docs.expo.dev/versions/latest/sdk/webbrowser/#webbrowseropenauthsessionasyncurl-redirecturl-options).
+ On native (iOS/Android), `signIn.social` does not navigate automatically. Handle navigation yourself after it resolves. Note that the [underlying browser behavior differs by platform](https://docs.expo.dev/versions/latest/sdk/webbrowser/#webbrowseropenauthsessionasyncurl-redirecturl-options).
#### IdToken Sign-In
diff --git a/docs/content/docs/integrations/nitro.mdx b/docs/content/docs/integrations/nitro.mdx
index 9a028ca0bc..afcb3d7ad1 100644
--- a/docs/content/docs/integrations/nitro.mdx
+++ b/docs/content/docs/integrations/nitro.mdx
@@ -196,4 +196,4 @@ export default defineEventHandler({
### Example
-You can find an example of a Nitro application integrated with Better Auth & Prisma [here](https://github.com/BayBreezy/nitrojs-better-auth-prisma).
+See an [example Nitro application integrated with Better Auth & Prisma](https://github.com/BayBreezy/nitrojs-better-auth-prisma).
diff --git a/docs/content/docs/reference/contributing.mdx b/docs/content/docs/reference/contributing.mdx
index d379f36388..6f188a347c 100644
--- a/docs/content/docs/reference/contributing.mdx
+++ b/docs/content/docs/reference/contributing.mdx
@@ -105,9 +105,9 @@ Once you have an idea of what you want to contribute, you can start making chang
* Make your changes to the codebase.
- * Write tests if needed. (Read more about testing here)
+ * Write tests if needed. (Read more about testing)
- * Update documentation. (Read more about documenting here)
+ * Update documentation. (Read more about documenting)
diff --git a/packages/better-auth/src/api/routes/error.ts b/packages/better-auth/src/api/routes/error.ts
index 82e0398bde..a67ab84f1b 100644
--- a/packages/better-auth/src/api/routes/error.ts
+++ b/packages/better-auth/src/api/routes/error.ts
@@ -305,8 +305,8 @@ ${
>
${
!description
- ? "We encountered an unexpected error. Please try again or return to the home page. If you're a developer, you can find more information about the error " +
- `here.`
+ ? "We encountered an unexpected error. Please try again or return to the home page. If you're a developer, you can find " +
+ `more information about the error.`
: description
}