README.md

Admin Starter

A TypeScript monorepo is implementing pieces of Better Auth in a Hono API, with a TanStack Start web app consuming it to demonstrate how they work together. 🎓

It started as a starter template with no business logic, an experiment in a monorepo, focusing on file structure and build setup. Over time, the project naturally evolved, and I introduced features as the need arose.

The custom features are easily removable, so you can grab the files and use them to kick-start your own project.

Note

This isn’t even the final form. Its exact purpose are still evolving.

Architecture

flowchart LR
  subgraph "monorepo"
    A["📁 apps/api<br/>Hono API<br/>Better Auth"]
    W["📁 apps/web<br/>TanStack Start<br/>React + SSR"]
    P["📁 packages/*<br/>Zod schemas<br/>shared utilities"]
    WW["📁 apps/cli<br/>CLI to drive Ollama"]
  end

  U((User))
  UW(((CLI)))
  D[(PostgreSQL)]
  E{{Emails}}
  O{Ollama}

  P -.-> A
  P -.-> W
  P -.-> WW

  U <-->|Web| W
  U <-->|Mobile| A
  UW <-->|HTTP| A
  UW <==> O
  WW -.-> UW

  W <-->|HTTP| A
  A <==> D
  A -->|SMTP| E

Loading

Features

User	Admin	Docker Compose
🔹 Register and verify your email 🔹 Update your profile 🔹 Log in with cookies or bearer tokens	🔹 View users 🔹 Revoke sessions	▪️ db ▪️ mail ▪️ api ▪️ web

Demo

Click Here for the demo!

It’s an ephemeral database. 🛡️
Register, or use a test credential to sign in.

Quick Start

Working defaults in the compose config and in .env files.

Just run:

docker compose up -d

Docker Compose mounts the PostgreSQL data in the ./pgdata folder.
Open http://localhost:3000 to access the UI.

More details on the dev page.

Documentation

A wise man once told me the source code is the best documentation. Share it with your favourite AI agent and ask for the details. That Jekyll page is anything but RTFM.

Stack

Package	API	Web	CLI	Description
Better Auth	✓	✓	✓	Authentication framework on PostgreSQL
Biome	✓	✓	✓	Code format and linter
Bun	✓	✓	✓	TypeScript runtime
Clack			✓	CLI library
Hono	✓			API framework
Lucide		✓		Icons
Nodemailer	✓			Send emails
Pino	✓			Logger
React	✓	✓		Library for user intrfaces (emails in API)
Tailwind CSS		✓		Utility-first CSS framework
TanStack Form		✓		Headless UI for type-safe forms
TanStack Query		✓		Data fetching
TanStack Start		✓		Full-stack framework powered by Vite
TanStack Table		✓		Headless UI for tables & datagrids
Zod	✓	✓		Schema validation with static type inference