better-auth-kit 🔐

A CLI that scaffolds a production-ready Next.js + TypeScript project with Better Auth pre-configured in seconds.

📦 Installation

You can use it directly without installing:

npx better-auth-kit <project-name>

Or install it globally:

npm install -g better-auth-kit
better-auth-kit <project-name>

🚀 Quick Start

npx better-auth-kit my-app
cd my-app
npm install
npm dev

That's it. Your project is scaffolded and ready to go.

✨ What You Get

Every project scaffolded with better-auth-kit comes with:

• 🔐 Better Auth — credentials & Google OAuth pre-configured
• 🟦 TypeScript — fully typed from day one
• ⚡ Next.js 15 — App Router, Server Actions, the works
• 🗄️ Prisma + PostgreSQL — schema and migrations ready to run
• 🎨 Tailwind CSS + ShadCN UI — clean, accessible component library
• 📁 Sensible project structure — no clutter, no guesswork

🖥️ CLI Usage

better-auth-kit <project-name>

Arguments

| Argument | Description | |---|---| | <project-name> | The name of the project to scaffold |

Example

npx better-auth-kit my-saas-app

This will:

1. Clone the TypeScript starter template
2. Rename the project
3. Install all dependencies
4. Print next steps

⚙️ After Scaffolding

1. Set Up Environment Variables

Create a .env file in your project root:

# Better Auth
BETTER_AUTH_SECRET=<your_better_auth_secret>
BETTER_AUTH_URL=http://localhost:3000

# PostgreSQL
DATABASE_URL="postgresql://<username>:<password>@<host>/<database_name>?sslmode=require"

# Google OAuth
GOOGLE_CLIENT_ID=<your_google_client_id>
GOOGLE_CLIENT_SECRET=<your_google_client_secret>

💡 Generate a secure secret with: openssl rand -base64 32

2. Run Database Migrations

npx prisma migrate dev

3. Start the Dev Server

npm dev

App runs at http://localhost:3000.

📁 Scaffolded Project Structure

my-app/
├── app/
│   ├── (auth)/           # Login & register pages
│   ├── (dashboard)/      # Protected routes
│   └── api/auth/         # Better Auth API route
├── components/           # ShadCN UI components
├── lib/
│   └── auth.ts           # Better Auth config
├── prisma/
│   └── schema.prisma     # Database schema
├── .env                  # Environment variables
└── package.json

🔗 Live Demo

See the scaffolded template live: better-auth-kit.vercel.app

🤝 Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m 'add my feature'
4. Push to the branch: git push origin feature/my-feature
5. Open a pull request

📄 License

MIT © Watuulo Richard