First-Time SetupCopy Anchor Link

Once you have installed the prerequisites and cloned a project repository, perform the initial environment configuration before launching services.

1. Environment SecretsCopy Anchor Link

Copy the example environment template into your active .env.local:

cp .env.example .env.local

Fill in the required local configuration parameters:

# Local Application Port
PORT=3000

# Auth & Cryptography
NEXTAUTH_SECRET=development_secret_32_characters_long!
NEXIUM_API_KEY=nexium_sandbox_token_88252

# Database Connection (PostgreSQL)
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/nexium_dev"

# Razorpay Sandbox Credentials
RAZORPAY_KEY_ID="rzp_test_sampleKey"
RAZORPAY_KEY_SECRET="sampleSecretKey"

# Site Metadata
NEXT_PUBLIC_SITE_URL="https://www.nexiummedia.com"

2. Boot Local DatabaseCopy Anchor Link

We use Docker Compose to start local PostgreSQL and Redis instances:

docker compose up -d

Verify that the containers are healthy:

docker ps

3. Run Database MigrationsCopy Anchor Link

Apply database schemas and seed realistic test accounts:

npm run db:migrate
npm run db:seed

4. Start Development ServerCopy Anchor Link

Run the development command with Turbopack:

npm run dev

Visit http://localhost:3000 in your browser. You should see the application loaded with live hot-reloading!