next-launch — Next.js SaaS Template

SHA-256: 24992ad20f8d7108f2a9e2c6485c8801fba12d405ea8bd08d3ced81ed157d9fa

2026-10-14T18:12:19.231Z

# NextStack

A production-ready Next.js starter with authentication, a type-safe database, and a complete UI system — all pre-configured so you can start building on day one.

## Stack

| Layer | Technology |
|---|---|
| Framework | [Next.js 15](https://nextjs.org) (App Router, Turbopack) |
| Language | [TypeScript](https://www.typescriptlang.org) |
| Auth | [Better Auth](https://better-auth.com) |
| Database ORM | [Prisma 7](https://www.prisma.io) (PostgreSQL) |
| UI Components | [shadcn/ui](https://ui.shadcn.com) |
| Styling | [Tailwind CSS v4](https://tailwindcss.com) |
| Fonts | [Geist](https://vercel.com/font) |

## Features

- **Email/password auth** — sign up, sign in, session management
- **OAuth** — Google and GitHub (enable by adding env vars)
- **Two-factor authentication** — TOTP-based 2FA via Better Auth plugin
- **Protected routes** — middleware-based route protection, ready to extend
- **Type-safe database** — Prisma client with full TypeScript inference
- **Component library** — 50+ shadcn/ui components pre-installed
- **Dark mode** — light/dark theme with `next-themes`
- **Reusable auth templates** — single `AuthPage` component drives both sign-in and sign-up
- **Project config** — one file (`config/app.ts`) to rename and rebrand everything

---

## Getting Started

### 1. Clone the repository

```bash
git clone https://github.com/adityayaduvanshi/next-launch.git
cd next-launch
```

### 2. Install dependencies

```bash
npm install
```

### 3. Set up environment variables

```bash
cp env.example .env
```

Then fill in your values (see [Environment Variables](#environment-variables) below).

### 4. Push the database schema

```bash
npx prisma migrate dev --name init
```

### 5. Start the dev server

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000).

---

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `NEXT_PUBLIC_APP_URL` | Yes | Your app's public URL (e.g. `http://localhost:3000`) |
| `BETTER_AUTH_SECRET` | Yes | Random secret — run `openssl rand -base64 32` |
| `BETTER_AUTH_URL` | Yes | Same as `NEXT_PUBLIC_APP_URL` |
| `DATABASE_URL` | Yes | PostgreSQL connection string |
| `GOOGLE_CLIENT_ID` | Optional | Enables Google OAuth |
| `GOOGLE_CLIENT_SECRET` | Optional | Enables Google OAuth |
| `GITHUB_CLIENT_ID` | Optional | Enables GitHub OAuth |
| `GITHUB_CLIENT_SECRET` | Optional | Enables GitHub OAuth |

> OAuth providers are **automatically disabled** if their env vars are not set — no code changes needed.

---

## Project Structure

```
next-app/
├── app/
│   ├── (auth)/                  # Auth route group
│   │   ├── _components/
│   │   │   ├── auth-form.tsx    # Shared sign-in / sign-up form
│   │   │   └── auth-page.tsx    # Page shell with logic & layout
│   │   ├── sign-in/[[...sign-in]]/page.tsx
│   │   └── sign-up/[[...sign-up]]/page.tsx
│   ├── (marketing)/             # Public marketing pages
│   │   ├── _components/
│   │   │   └── theme-toggle.tsx
│   │   └── page.tsx             # Landing page
│   ├── globals.css
│   └── layout.tsx               # Root layout with metadata
├── config/
│   └── app.ts                   # ← Project name, description, URL
├── lib/
│   ├── auth/
│   │   ├── auth.ts              # Better Auth server config
│   │   ├── auth-client.ts       # Better Auth browser client
│   │   └── index.ts
│   ├── db.ts                    # Prisma client singleton
│   └── utils.ts
├── prisma/
│   └── schema.prisma            # Database schema
├── components/
│   └── ui/                      # shadcn/ui components
└── env.example
```

---

## Customization

### Rename the project

Edit `config/app.ts` — this is the single source of truth for your app's name, description, and URL:

```ts
export const appConfig = {
  name: "YourApp",
  description: "Your app description",
  url: "https://yourapp.com",
}
```

### Add a database model

1. Add your model to `prisma/schema.prisma`
2. Run `npx prisma migrate dev --name your-model`
3. Use it anywhere via `import db from "@/lib/db"`

```ts
import db from "@/lib/db"

const posts = await db.post.findMany({
  where: { authorId: session.user.id },
})
```

### Access the session in a Server Component

```ts
import { headers } from "next/headers"
import { auth } from "@/lib/auth"

export default async function Page() {
  const session = await auth.api.getSession({
    headers: await headers(),
  })

  if (!session) redirect("/sign-in")

  return <div>Hello, {session.user.name}</div>
}
```

### Add an OAuth provider

1. Add credentials to `.env`:
   ```
   GOOGLE_CLIENT_ID=your-client-id
   GOOGLE_CLIENT_SECRET=your-client-secret
   ```
2. Set the OAuth callback URL in your provider's dashboard:
   ```
   http://localhost:3000/api/auth/callback/google
   ```

That's it — the provider activates automatically.

### Enable / disable Two-Factor Auth

2FA is enabled by default via the `twoFactor()` plugin in `lib/auth/auth.ts`. Remove it from the `plugins` array to disable it.

---

## Available Scripts

```bash
npm run dev          # Start dev server (Turbopack)
npm run build        # Production build
npm run start        # Start production server
npm run typecheck    # TypeScript type check
npm run lint         # ESLint
npm run format       # Prettier
```

---

## Deployment

### Vercel (recommended)

```bash
npm i -g vercel
vercel
```

Set all environment variables in the Vercel dashboard under **Settings → Environment Variables**. Make sure `NEXT_PUBLIC_APP_URL` and `BETTER_AUTH_URL` are set to your production domain.

### Docker / other platforms

Build the production image:

```bash
npm run build
npm run start
```

The app runs on port `3000` by default.

---

## License

MIT — use this for anything, personal or commercial.