Configuration

Hoikka uses environment variables for configuration. No XML, YAML, or admin panels needed.

When using the Vercel deploy button, DATABASE_URL and BLOB_READ_WRITE_TOKEN are provisioned automatically. Use bunx vercel env pull .env.local to sync them locally.

Required Variables

Database

DATABASE_URL="postgresql://user:password@localhost:5432/hoikka"

Authentication (Neon Auth)

NEON_AUTH_BASE_URL=
NEON_AUTH_COOKIE_SECRET=

Enable Auth in your Neon Console  to get these credentials.

Images (Vercel Blob)

BLOB_READ_WRITE_TOKEN=

Auto-provisioned when connecting a Blob store in your Vercel Dashboard .

Optional Variables

Payments (Stripe)

STRIPE_SECRET_KEY="sk_test_..."
PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_..."

Stripe is optional for getting started. A mock payment provider is available for development and testing. When ready for production, get credentials from your Stripe Dashboard .

Email (Resend)

RESEND_API_KEY="re_..."
RESEND_FROM_EMAIL="noreply@yourdomain.com"

Used for digital product delivery emails. Optional — if not set, email delivery is skipped. Get an API key from Resend .