Quick Deploy Guide
In this guide, you'll learn how to quickly deploy your Nextacular project over at Vercel. After successfully going through this guide, you'll feel confident in handling your own deployment.
Prerequisites
Vercel - https://vercel.com/
A Vercel account is required in order for us to successfully deploy our SaaS project. Head over to Vercel and create your account now.
Email
Check out our supported email providers here and how to set them up:
EmailAuthentication
Visit NextAuth.js for additional setup of other providers.
AuthenticationPayment
You will need to set up an account with stripe and create the products.
Check out our supported payment providers here and how to set them up:
PaymentDatabase
Check out our supported database providers here and how to set them up:
DatabaseAnalytics
Check out our supported analytics providers here and how to set them up:
AnalyticsSteps
1. Deploy a Vercel Project
Create a Vercel Authorization Token
Prepare a Vercel Authorization Token in your account dashboard by clicking the "Create" button in the "Tokens" settings.
Create a Vercel Project
Create a new project in your Vercel dashboard by clicking the "+ New Project" button.
Import Git Repository
If this is your first time deploying a project in Vercel, connect your repository provider and authorize specific projects.
After authorizing repositories for deployment, click the "Import" button for your specific project.
Configure Project
Update your project configurations such as your Project Name.
Add Environment Variables
Set up your Environment Variables by adding the following values:
# App Configuration
APP_URL
NEXTAUTH_URL
NEXTAUTH_SECRET
# Database Configuration
DATABASE_URL
SHADOW_DATABASE_URL
# Email Configuration
EMAIL_FROM
EMAIL_SERVER_USER
EMAIL_SERVER_PASSWORD
EMAIL_SERVICE
# Payment Configuration (Stripe)
NEXT_PUBLIC_PUBLISHABLE_KEY
PAYMENTS_SECRET_KEY
PAYMENTS_SIGNING_SECRET
# Vercel Configuration
NEXT_PUBLIC_VERCEL_IP_ADDRESS
VERCEL_AUTH_BEARER_TOKEN
# Analytics Configuration
NEXT_PUBLIC_GOOGLE_ANALYTICS_IDIf you can't provide all of these environment variables, some expected functionality won't work.
App Configuration - authentication and application build will fail
Database Configuration - application build will fail and the database connection error will occur
Email Configuration -
nodemailerwill throw an error and sending of emails (ie. authentication) won't workPayment Configuration - the project will still work, but errors in billing and product display pages will occur
Vercel Configuration - the project will still work, but errors in the domain configuration pages will occur
Analytics Configuration - the project will still work, but warnings and errors are thrown on the client's console
Please refer to this documentation for more details:
Environment VariablesDeploy
Click the "Deploy" button and wait for the build to finish.
If you encounter any issues while building the project, please don't hesitate to raise them over at our Discord channel. (https://discord.gg/GnCnzWbzDT)
2. Domain Configuration
DNS Nameservers Migrated to Vercel
Select your project, and go to your settings page. On the left side, you'll be able to set your "Domains". Add the following domains here to allow multi-tenancy for your project:
yourdomain.com (Add yourdomain.com and redirect www.yourdomain.com to it – 2nd option)
*.yourdomain.com
3. Post Build Configuration
During this time, your application should have been built successfully, but we're not quite there yet. In order for us to have a fully-working application, we need to set up additional environment variables, most especially the ones associated with your Vercel account (which were created after the build happened).
The following Environment Variables should be added:
# Vercel Configuration
VERCEL_PROJECT_ID
VERCEL_TEAM_ID
# 3rd-Party Services Configuration
# If you intend to use third-party applications,
# this is the best time you should add them to your list of
# environment variablesLast updated
Was this helpful?