Arabic error toasts for Better Auth

🌍

Written for real users

Modern Standard Arabic messages for every Better Auth error code, phrased the way an app would say it, not translated word for word.

🔄

Always in sync

The code list is generated from Better Auth itself. A daily workflow opens a pull request when a release adds codes, and TypeScript fails until each one is translated.

⚡

One line to use

Call authToast(error) in your existing flow, or wrap a call with withAuthToast() so you never write the if.

📦

Tiny and typed

About 7 KB gzipped with no runtime dependencies. ErrorCode is a union of every Better Auth code, so typos fail to compile.

🧩

Built for shadcn/ui

Toasts use Sonner, the toast component of shadcn/ui. The /translate entry has no peer dependency and works with any toast library.

🛡️

Safe by default

Prototype-safe lookup, conservative network detection, and server internals are never shown to your users.

See it in action

Better Auth returns a stable error code. better-auth-tarjim looks it up and shows the Arabic message in a Sonner toast, in right-to-left.

البريد الإلكتروني أو كلمة المرور غير صحيحة

error.code === "INVALID_EMAIL_OR_PASSWORD"

يرجى تأكيد بريدك الإلكتروني أولاً

error.code === "EMAIL_NOT_VERIFIED"

هذا الحساب موجود مسبقاً

error.code === "USER_ALREADY_EXISTS"

انتهت الجلسة، أعد تسجيل الدخول للمتابعة

error.code === "SESSION_EXPIRED"

Quick start

bash

npm i better-auth-tarjim

tsx

import { authToast } from "better-auth-tarjim";

const { error } = await authClient.signIn.email({ email, password });
if (error) authToast(error); // البريد الإلكتروني أو كلمة المرور غير صحيحة

Add Sonner's <Toaster dir="rtl" /> once in your root layout. The getting started guide covers the full setup, and usage covers withAuthToast, overrides, and the Sonner-free entry point.

Why codes, not text?

Better Auth keeps its error codes stable while its English messages can change between releases. This package matches on codes only, so a wording change upstream can never break your Arabic messages. When Better Auth adds a code, the generated ErrorCode type changes and the build tells you exactly which translation is missing.

Unofficial package

better-auth-tarjim is a community project. It is not affiliated with Better Auth, and it is released under the MIT License.

better-auth-tarjimArabic error messages for Better Auth