Self-Hosting

Wishpr can be deployed to any platform that supports Next.js. Here are the requirements and platform-specific guides.

Requirements

  • Node.js 18+ or any serverless platform
  • PostgreSQL database (Neon recommended)
  • DATABASE_URL environment variable
  • BLOB_READ_WRITE_TOKEN for card image uploads (optional, Vercel Blob)

Deployment Platforms

  • Vercel (recommended) - Zero config, connect Neon + Blob integrations directly
  • Railway - Supports PostgreSQL natively, add Blob token manually
  • Render - Free tier available for hobby projects
  • Docker - Self-host anywhere with a Dockerfile

Minimal .env.local

.env.local
# Required
DATABASE_URL=postgresql://user:pass@host/dbname?sslmode=require

# Optional - Blob storage for card images
BLOB_READ_WRITE_TOKEN=vercel_blob_...

# Optional - Branding overrides
NEXT_PUBLIC_APP_NAME=Wishpr
NEXT_PUBLIC_APP_DOMAIN=wishpr.sidihost.sbs
NEXT_PUBLIC_BRAND_NAME=Imoogle Technology
NEXT_PUBLIC_BRAND_URL=https://imoogle.com
NEXT_PUBLIC_GITHUB_URL=https://github.com/your-org/wishpr
NEXT_PUBLIC_PRIMARY_COLOR=#01b4e4
NEXT_PUBLIC_SECONDARY_COLOR=#90cea1
NEXT_PUBLIC_ACCENT_COLOR=#0d253f

Database Setup

After setting your DATABASE_URL, run scripts/setup-database.sql against your database to create the required tables. On Neon, use the SQL Editor in your dashboard.

PreviousQuick StartNextEnvironment Variables