A minimal Next.js boilerplate with authentication, database and a component library ready to go.

Prerequisites

• Node.js 18+
• Docker (recommended) or PostgreSQL running locally

Setup

1. Clone the repo

git clone https://github.com/mmilanovic4/forge.git
cd forge

2. Install dependencies

3. Create the environment file and fill in your values:

See the Environment Variables section below for the required values.

4. Start the database

5. Push the database schema

6. Generate the Prisma client

7. Start the dev server

Open http://localhost:3000.

Docker

The included docker-compose.yml spins up PostgreSQL and Mailpit.

docker compose up -d    # start in background
docker compose down     # stop
docker compose down -v  # stop and delete all data

Mailpit web UI is available at http://localhost:8025.

Environment Variables

User Roles

Forge uses two roles managed via Better Auth's admin plugin:

Admins can manage other users (ban, unban, change roles, delete) from the /users page. An admin cannot ban or delete their own account.

Social Auth

GitHub, Google, and Discord OAuth are supported but not configured by default. To enable them, create OAuth apps and add your credentials to .env.

Replace {APP_URL} with your BETTER_AUTH_URL value (e.g. http://localhost:3000).

• Discord — discord.com/developers/applications → New Application → OAuth2

  • Redirects: {APP_URL}/api/auth/callback/discord

• GitHub — github.com/settings/developers → New OAuth App

  • Homepage URL: {APP_URL}
  • Callback URL: {APP_URL}/api/auth/callback/github

• Google — console.cloud.google.com → APIs & Services → Credentials → Create OAuth 2.0 Client ID

  • Authorized JavaScript origins: {APP_URL}
  • Authorized redirect URI: {APP_URL}/api/auth/callback/google