kolm start admin

A TanStack Start + better-auth admin starter with Drizzle ORM, tRPC, React Aria.
Report Bug · Request Feature

About The Project

A @tanstack/react-start + better-auth admin starter, with drizzle-orm, tRPC, react-aria-components.

This project is built with the better-auth framework, using its admin plugin as a starting point for user management. While being fairly complete, it provides basic building blocks that can be customized to fit different needs.

This setup is built for flexibility, allowing you to use it as an admin starter for an app or extend it into a multi-tenancy user management system, depending on your needs.

I've kept this as minimal and unopinionated as possible, relying primarily on the built-in functionalities provided by the following packages:

• @tanstack/react-start
• better-auth
• drizzle-orm
• tRPC
• @tanstack/react-form
• react-aria-components
• biome.js

Check out kolm-start, for a @tanstack/react-start starter with tRPC, drizzle-orm, better-auth and tailwindcss.

For a version with @radix-ui/themes, check out the radix-themes branch.

Getting Started

Prerequisites

npm install npm@latest -g

Installation

1. Clone the repo, or use the template

   git clone https://github.com/jellekuipers/kolm-start-admin.git

2. Change git remote url to avoid accidental pushes to base project

   git remote set-url origin github_username/repo_name
   git remote -v # confirm the changes

3. Install NPM packages

   npm install

4. Connect to your database in your .env

   DATABASE_URL=
   BETTER_AUTH_URL=

5. Initialize database

   npm run db:push

6. (optional in development) Seed the database with an admin user

   npm run db:seed

7. (optional in development) Seed the database with fake users

   npm run db:seed:dev

8. Start the dev server

   npm run dev

How to enable CORS

In app.config.ts add the following lines:

export default defineConfig({
  server: {
    preset: "node-server",
+    routeRules: {
+      "/api/**": {
+        cors: true,
+        headers: {
+          "access-control-allow-methods": "GET, POST",
+          "access-control-allow-credentials": "true",
+        },
+      },
+    },
  },
  vite: {
    plugins: [

Add the external clients to trustedOrigins in app/lib/auth.ts:

            emailDomainName: "kolm.start",
         }),
      ],
+     trustedOrigins: ["http://localhost:3001"],
   });

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/amazing-feature)
3. Commit your Changes (git commit -m 'Add some amazing-feature')
4. Push to the Branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Acknowledgments

• TanStack Start
• tRPC
• Drizzle ORM
• better-auth
• React Aria
• create-t3-app
• Best-README-Template