In general you can deploy the application to any hosting provider that supports Node.js. In this documentation we cover multiple deployment targets from serverless platforms like Vercel to self-hosted solutions with Docker.

Since Next.js is a framework built by Vercel, you will get the best developer experience when deploying to Vercel.

Project setting

To deploy SuperStarter on any hosting provider, you need to create 3 new projects for the app, api and web apps. After selecting your repository, change the Root Directory option to the app of choice e.g. apps/app. This should automatically detect the Next.js setup and as such, the build command and output directory.

Then, add all your environment variables to the project.

Finally, just hit “Deploy” and Vercel will take care of the rest!

Here we assume that you already know the differences between these applications and which ones you will deploy

Environment variables

We recommend making use of the Team Environment Variables feature of the hosting provider before deploying. Variables used by libraries need to exist in all packages and duplicating them can be a headache. Learn more about how environment variables work in SuperStarter.

First deployment may fail

The first time this may fail if you don’t place all the environment variables correctly. It’s fine. Make the first deployment fail, then correct the environment variables. Redeploy.