Strapi + Better Auth Dashboard

An admin panel dashboard plugin for Strapi that provides user management, session monitoring, and analytics for Better Auth authentication.

[!CAUTION] This plugin is in BETA state. It is by no means considered stable and should not be used in production. If you want to contribute to its development, please contact any of the maintainers.

Features

• Overview page with user metrics, growth charts, and cohort retention analysis
• User management: search, create, edit, delete, and ban users
• Session management: view and revoke active sessions per user from the user detail drawer
• Organization management (when the Better Auth organization plugin is enabled)
• Real-time active user tracking (DAU / WAU / MAU)
• Automatic feature detection — ban, 2FA, email verification, and organization UI adapts to your Better Auth config

Installation

The additional dashboard plugin requires you to have the Better Auth plugin already installed and configured.

Packages

npm install @better-auth/infra @strapi-community/plugin-better-auth-dashboard
# or
yarn add @better-auth/infra @strapi-community/plugin-better-auth-dashboard
# or
pnpm add @better-auth/infra @strapi-community/plugin-better-auth-dashboard

Configuration

[!CAUTION] This plugin only works if you have not changed the basePath of Better Auth. It needs to be the default /api/auth path.

In order to run this plugin you need to configure the dash() and jwt() plugins from Better Auth.

import { dash } from "@better-auth/infra";
import { betterAuth } from 'better-auth';
import { jwt } from 'better-auth/plugins';
import { strapiAdapter } from '@strapi-community/plugin-better-auth';

export const auth = betterAuth({
  database: strapiAdapter(),
  trustedOrigins: ['http://localhost:3000'],
  plugins: [
    jwt(),
    dash({
      apiUrl: process.env.STRAPI_URL || "http://localhost:1337",
      apiKey:
        process.env.BETTER_AUTH_DASHBOARD_SECRET ||
        "strapi-internal-dashboard-key",
    }),
  ],
  advanced: {
    database: {
      generateId: 'serial',
    },
  },
  emailAndPassword: {
    enabled: true,
  },
});

To enable the "Send verification email" and "Send password reset" actions in the user detail drawer, configure the dashboard plugin itself in config/plugins.js/.ts:

export default {
  "better-auth-dashboard": {
    config: {
      // Absolute URL of your public-facing client app. Used as the
      // callback destination for email verification / password reset
      // links sent from the dashboard. Unset by default — the two
      // actions above stay disabled until this is configured, rather
      // than guessing at a URL (e.g. the admin panel's own origin).
      email_callback_url: process.env.BETTER_AUTH_DASHBOARD_CALLBACK_URL,
    },
  },
};

Start Strapi

pnpm develop

The dashboard is now available in the Strapi admin panel.

Pages

| Tab | Description | | --- | ----------- | | Overview | User metrics, growth charts, cohort retention, active user rings | | Users | Searchable user table with create, edit, delete, ban, and session revoke per user | | Organizations | Organization list with member management (requires Better Auth organization plugin) |

Extending the dashboard

Other Strapi admin plugins can add sections and lazy-loaded screens through the dashboard plugin's admin API. Call the API during your plugin's bootstrap lifecycle:

export default {
  bootstrap(app) {
    const plugin = app.getPlugin("better-auth-dashboard");
    if (!plugin) return;

    const dashboard = plugin.apis;

    dashboard.addDashSection({
      id: "my-plugin",
      intlLabel: {
        id: "my-plugin.dashboard.section",
        defaultMessage: "My plugin",
      },
      priority: 20,
    });

    dashboard.addDashLink("my-plugin", {
      id: "my-plugin.audit-log",
      intlLabel: {
        id: "my-plugin.dashboard.audit-log",
        defaultMessage: "Audit log",
      },
      to: "/audit-log",
      Component: () => import("./pages/AuditLog"),
      permissions: [],
      isAvailable: async () => checkAuditLogAvailability(),
    });
  },
};

Available APIs:

| API | Description | | --- | --- | | addDashSection(section) | Creates a navigation section. priority controls section order. | | addDashLink(section, link) | Registers a lazy route and adds its link to a section. Supports Strapi admin permissions and sync or async isAvailable. | | getDashLinks() | Returns the live section and link registry. Treat the result as read-only. |

isAvailable defaults to true. Its result is cached for five minutes, combined with permission checks, and applied to both navigation and direct route access. Errors are treated as unavailable.

See the Dashboard documentation for the complete API reference and extension guidance.

Requirements

• @strapi-community/plugin-better-auth installed and configured
• Strapi v5.45.0+
• Better Auth >= 1.4.0

Resources

• Documentation
• Better Auth Documentation
• Strapi Documentation

Authors

• Boaz Poolman

License

See the LICENSE file for licensing information.