NextJS Deploy

Full-stack Next.js 16 template with complete local development setup and Dokploy VPS deployment.

• Framework: Next.js 16 (App Router, Cache Components, React Compiler)
• API: oRPC with Zod validation and OpenAPI documentation (Scalar)
• Database: PostgreSQL 16 + Prisma 7
• Auth: Better Auth
• UI: Tailwind CSS 4 + Base-UI
• DevOps: Docker, Dokploy, Traefik, Tailscale VPN
• Analytics: Umami (self-hosted)

Quick Start

Prerequisites

• Node.js
• PNPM
• Docker
• Make

Development

make dev

Next.js in terminal + Postgres in Docker. Installs dependencies, generates env files, sets up the database, loads fixtures and starts the server.

Build (test production locally)

make start

Full containerized environment

make basic

See Setup local for all options and details.

Documentation

Project — docs/nextjs-deploy/

• Setup local
• Environment variables
• Containerization
• Fixtures
• MCP Servers
• Git Usage
• GitHub Pipelines
• GitHub Env Setup
• Dokploy Env Setup
• Database Breaking Migrations

Good Practices — docs/good-practices/

• Next.js
• Components
• TypeScript
• Context
• useForm
• Query Parameters (nuqs)

Infrastructure — docs/vps-infra/

• Setup VPS
• Firewall config
• DNS config
• Swap file
• Common packages
• Docker install
• Dokploy install
• Claude Code
• Traefik DNS challenge
• Tailscale VPN
• Umami analytics

Fixtures

Test credentials:

Email	Password	Role
admin@example.com	Password1234!	ADMIN
user@example.com	Password1234!	USER

See Fixtures for details.