Env Variables

To get Supersaas running, you need to set a few environment variables in a .env file. You can use the provided .env.example as a starting point.

Supersaas uses strict environment validation powered by @t3-oss/env-nuxt. If any required variable is missing or invalid, the app won’t start. This helps catch issues early and avoids silent bugs in production.

Mandatory Variables

Here’s a breakdown of what each section in the .env.example file does:

App Configuration

BASE_URL=http://localhost:3000
APP_NAME=Supersaas
APP_DESCRIPTION="The complete Nuxt 3 SaaS starter kit."
LOGO_URL=https://supersaas.dev/logo.png
MOCK_EMAIL=true

• BASE_URL: Your app’s base URL.
• APP_NAME, APP_DESCRIPTION, LOGO_URL: Used across meta tags and UI.
• MOCK_EMAIL: If set to true, email sending is skipped and emails are logged to the console.

Email Settings

Supersaas uses useEmail to send emails, it allows you to use multiple email providers using a unified API.

Set the credentials for your preferred provider using the variables below:

# Mailgun
MAILGUN_API_KEY=<TOKEN>
MAILGUN_DOMAIN=<DOMAIN>

#Plunk
PLUNK_API_TOKEN=<TOKEN>

#Postmark
POSTMARK_SERVER_TOKEN=<token>

#Resend
RESEND_API_TOKEN=<TOKEN>

#Sendgrid
SENDGRID_API_KEY=<TOKEN>

#ZEPTOMAIL
ZEPTOMAIL_API_KEY=<TOKEN>

[email protected]
EMAIL_PROVIDER=resend

The FROM_EMAIL should be a verified sender from your chosen provider. Set EMAIL_PROVIDER to one of the following:

resend | mailgun | plunk | postmark | sendgrid | zeptomail

Read more about emails here.

Authentication

NUXT_OAUTH_GITHUB_CLIENT_ID=XXXXXXXX
NUXT_OAUTH_GITHUB_CLIENT_SECRET=XXXXXXXX
NUXT_OAUTH_GOOGLE_CLIENT_ID=XXXXXXXX
NUXT_OAUTH_GOOGLE_CLIENT_SECRET=XXXXXXXX
NUXT_SESSION_PASSWORD=XXXXXXXX

• OAuth fields are optional unless you want GitHub/Google login (or any other provider from nuxt-auth-utils).
• NUXT_SESSION_PASSWORD is mandatory and must be 32+ characters. It’s used to seal session cookies.

Stripe Payments

PAYMENT_PROVIDER=stripe
NUXT_STRIPE_SECRET_KEY=sk_test_XXXXXXXX
NUXT_STRIPE_WEBHOOK_SECRET=whsec_XXXXXXXX

Required if you want to enable payments.

Twilio (Optional)

TWILIO_ACCOUNT_SID=ACXXXX
TWILIO_AUTH_TOKEN=XXXX
TWILIO_PHONE_NUMBER=+1234567890

Needed only if you're enabling phone number login/OTP via SMS.

S3 Storage (Optional)

S3_ACCESS_KEY_ID=XXXXXXXXX
S3_SECRET_ACCESS_KEY=XXXXXXXXXX
S3_BUCKET=your-bucket-name
S3_REGION=your-region
S3_ENDPOINT=your-endpoint
S3_PUBLIC_ENDPOINT=your-public-endpoint

Used for file uploads if you're not using NuxtHub.

Postgres (Optional)

Required only if you're not using NuxtHub and plan to use Postgres.

POSTGRES_URL="postgresql://[email protected]:5432/your-database-name"

Turso (Optional)

Alternative to Postgres or NuxtHub, only needed if you're using Turso.

TURSO_DB_URL=libsql://XXXX-XXXX-XXXX.turso.io
TURSO_DB_TOKEN=XXXXXXXX

Strict Env Validation

Supersaas uses @t3-oss/env-nuxt to validate environment variables at build time. If anything is missing or misconfigured, the app will crash with a clear error, so you know exactly what needs fixing.

Skipping Validation (Not Recommended)

Do this only if you know what you're doing.

If you want to disable strict env checks (maybe just to explore the code or boot up the UI), you can remove the validation logic:

1. Delete the file that contains the createEnv() logic (usually utils/env.ts or similar).
2. Remove the import from nuxt.config.ts:

import "./env";

Once you’ve filled in all the required values, restart your dev server:

pnpm dev

You're good to go.