Documentation
Documentation
Introduction

Getting Started

Getting started
Getting StartedInstallationQuick StartProject Structure

Configuration

Configuration
ConfigurationEnvironment ConfigurationEdge ConfigDatabaseAuth SecretStripeFirebaseStorageGoogle Maps And Cloud Service AccountOAuth ProvidersEmail DeliverySentryFeature Flags

Architecture

Architecture
Architecture OverviewTech StackoRPC MiddlewareDesign Principles

Patterns

Patterns
Code Patterns & ConventionsFeature ModulesError HandlingType Safety

Database

Database
DatabaseSetupSchema DefinitionDatabase OperationsMigrationsCaching
Data Tables

API

oRPCProceduresRoutersoRPC Proxy Setup
APIsOpenAPIREST Endpoints

Auth & Access

AuthenticationConfigurationOAuth ProvidersRolesSession Management
AuthorizationUser RolesPermissions

Routing & i18n

RoutingDeclarative RoutingNavigation
InternationalizationTranslationsLocale Routing

Components & UI

ComponentsButtonsFormsNavigationDialogs
StylesTailwind CSSThemingTypography

Storage

Storage
StorageConfigurationUsageBuckets
Stripe Billing

Extra

Caching

Templates

Templates
Template GuidesCreate New FeatureCreate New PageCreate Database TableCreate oRPC RouterAdd Translations

Development

Development
DevelopmentCommandsAI AgentsBest Practices
Pulling Updates

Email Delivery

Configure Resend and SMTP fallback settings

Variables

VariableRequiredPurpose
RESEND_API_KEYOptionalDirect API-based delivery with Resend.
EMAIL_SENDERYesSender display name.
EMAIL_DOMAINYesSender domain root.
NODEMAILER_EMAIL_HOSTYes (SMTP path)SMTP host.
NODEMAILER_EMAIL_PORTYes (SMTP path)SMTP port.
NODEMAILER_EMAIL_USERNAMEYes (SMTP path)SMTP username/login.
NODEMAILER_EMAIL_PASSWORDYes (SMTP path)SMTP password/token.
NODEMAILER_FALLBACK_EMAILYes (SMTP path)Fallback sender mailbox.

Resend Setup

  1. Create account at https://resend.com.
  2. In dashboard, open Domains and verify your sending domain.
  3. Open API Keys and click Create API Key.
  4. Copy key and add it to RESEND_API_KEY.
RESEND_API_KEY="re_..."
EMAIL_SENDER="My Company"
EMAIL_DOMAIN="example.com"

SMTP (Nodemailer) Setup

Use your mail provider SMTP values (Resend SMTP, Mailgun, SendGrid, Postmark, or custom SMTP).

NODEMAILER_EMAIL_HOST="smtp.your-provider.com"
NODEMAILER_EMAIL_PORT="465"
NODEMAILER_EMAIL_USERNAME="smtp-username"
NODEMAILER_EMAIL_PASSWORD="smtp-password"
NODEMAILER_FALLBACK_EMAIL="noreply@example.com"

Provider Strategy

  1. Configure at least one delivery path.
  2. Prefer API delivery (RESEND_API_KEY) when available.
  3. Keep SMTP fallback valid for resilience.

Keep all email credentials server-side. Never expose them as NEXT_PUBLIC_* variables.

On this page

Variables
Resend Setup
SMTP (Nodemailer) Setup
Provider Strategy