Deployment

Prepare the shadcn admin dashboard template for production, configure environment variables, and deploy it to your preferred platform.

Pre-deployment checklist

  • Run type checking, linting, and a production build locally.
  • Set all required environment variables on the hosting platform.
  • Connect auth, database, and API services before protecting routes.
  • Remove unused pages, demo data, test credentials, and placeholder links.
  • Confirm light mode, dark mode, responsive layouts, and important workflows.

Build locally

Create a production build before deploying:

Preview the production build locally:

Deployment Platforms

Choose a platform to deploy your application:

Vercel

Recommended

The easiest way to deploy Next.js applications. Automatic deployments from Git with zero configuration.

Deploy to Vercel →

Netlify

Another excellent platform with automatic deployments and serverless functions support.

Deploy to Netlify →

Self-Hosted

Deploy to any Node.js hosting provider like AWS, DigitalOcean, or your own server. Requires Node.js 18.17 or higher.

Learn about self-hosting →

Common troubleshooting

IssueWhat to check
Port 3000 is in useRun pnpm dev --port 3001 and update your app URL environment value.
Build works locally but fails in productionCompare Node.js version, environment variables, and missing service credentials.
Images do not loadCheck image paths, CDN domains, base path, and remote image configuration.
Dark mode or theme changes do not applyRestart the dev server after changing global CSS or theme variables.