Skip to content

Releases: podalls97/tanstack-betterauth

v1.0.0 - Initial Release

Choose a tag to compare

@podalls97 podalls97 released this 24 Dec 17:27

Full-Stack Authentication System with Access Request Workflows

This is the first stable release of the authentication platform, featuring a
complete user access management system with admin controls.

Features

Authentication System

  • Email/password authentication with BetterAuth
  • Username support (3-30 characters)
  • Password reset flow via email
  • Role-based access control (user/admin)
  • 7-day session management with automatic updates

Access Request Workflow

  • User access request form with custom reasoning
  • Admin dashboard for managing requests (approve/reject)
  • Email notifications for admins on new requests
  • Automated password reset emails for approved users
  • Admin notes and feedback on rejections

Tech Stack

  • Framework: TanStack Start (React-based meta-framework with SSR/SSG)
  • Runtime: Bun with Node.js compatibility
  • Database: Neon PostgreSQL (serverless)
  • ORM: Drizzle ORM with HTTP client
  • Auth: BetterAuth with username plugin
  • Email: Resend for transactional emails
  • UI: Tailwind CSS v4 + shadcn/ui (radix-lyra style)
  • Icons: Lucide React

Developer Experience

  • File-based routing with route groups
  • Pre-configured shadcn/ui components
  • Type-safe database schema with Drizzle
  • Path aliases (@/* → src/*)
  • Testing setup with Vitest
  • ESLint + Prettier configuration

Getting Started

  1. Clone the repository
  2. Install dependencies: bun install
  3. Set up environment variables (see .env.example)
  4. Push database schema: bunx drizzle-kit push
  5. Start dev server: bun dev

Environment Variables Required

DATABASE_URL # Neon PostgreSQL connection
BETTER_AUTH_SECRET # Min 32 characters
BETTER_AUTH_URL # App URL
RESEND_API_KEY # Resend API key
ADMIN_EMAIL # Admin notifications
EMAIL_FROM # Verified sender

What's Next?

This is a stable foundation for authentication and access management. Future
releases may include:

  • OAuth provider support
  • Email verification flow
  • Enhanced admin analytics
  • Audit logging

Full Changelog: Initial release