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

• Bun
• 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

Docker build (test production image locally)

make docker

See Setup local for all options and details.

Documentation

Project — docs/nextjs-deploy/

• Quick Deploy — Deploy on existing Dokploy infra
• Setup local
• Environment variables
• Containerization
• Fixtures
• MCP Servers
• Git Usage
• GitHub Pipelines
• GitHub Env Setup
• Dokploy Env Setup
• Database Breaking Migrations
• Scheduled Tasks
• Better Auth Fork

Good Practices — docs/good-practices/

• Next.js
• Components
• TypeScript
• Context
• Forms
• Query State (nuqs)
• Cookie State
• Cross-Component State
• oRPC
• Base UI
• Theme
• Password Managers

Security — docs/security/

• Audit Plan — Security & legal implementation status
• Standards — OWASP, RGPD/CNIL, ANSSI reference

Testing — docs/testing/

• Overview — Full test inventory (373 tests)
• E2E
• Unit
• Integration
• Functional

Infrastructure — docs/vps-infra/

• Quick Install — VPS setup from scratch
• Setup VPS
• Firewall config
• DNS config
• Swap file
• Common packages
• Docker install
• Dokploy install
• Claude Code
• Traefik DNS challenge
• Tailscale VPN
• Umami analytics
• Cloudflare R2

Fixtures

Test credentials:

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

See Fixtures for details.