From fde043207ef3d5a5e1f74aa5ddabf77d523d52d4 Mon Sep 17 00:00:00 2001 From: Maxwell <145994855+ping-maxwell@users.noreply.github.com> Date: Sat, 9 May 2026 21:31:27 +1000 Subject: [PATCH] fix: improve link accessibility issues (#9521) Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> Co-authored-by: Josh Soref <2119212+jsoref@users.noreply.github.com> Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> --- .changeset/upset-worlds-like.md | 5 +++++ .github/ISSUE_TEMPLATE/bug_report.yml | 6 +++--- .github/ISSUE_TEMPLATE/feature_request.yml | 6 +++--- .../blogs/0-supabase-auth-to-planetscale-migration.mdx | 5 ++--- docs/content/docs/adapters/other-relational-databases.mdx | 3 +-- docs/content/docs/adapters/prisma.mdx | 2 +- docs/content/docs/guides/clerk-migration-guide.mdx | 2 +- docs/content/docs/guides/optimizing-for-performance.mdx | 6 +++--- docs/content/docs/guides/workos-migration-guide.mdx | 2 +- docs/content/docs/integrations/convex.mdx | 4 ++-- docs/content/docs/integrations/expo.mdx | 4 ++-- docs/content/docs/integrations/nitro.mdx | 2 +- docs/content/docs/reference/contributing.mdx | 4 ++-- packages/better-auth/src/api/routes/error.ts | 4 ++-- 14 files changed, 29 insertions(+), 26 deletions(-) create mode 100644 .changeset/upset-worlds-like.md 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 }