Installation

Requirements

• Node.js ≥ 22
• pnpm
• Supabase project (local or hosted)

Setup

git clone <repository-url>
cd neverline
pnpm install

Environment Variables

Copy the example environment variables template and configure the required parameters:

cp services/api/.env.example services/api/.env

Required variables:

Variable	Description
SUPABASE_URL	Your Supabase project URL
SUPABASE_SERVICE_ROLE_KEY	Service role key (server-side only)
SUPABASE_ANON_KEY	Anonymous key (client-side)
PII_ENCRYPTION_KEY	32-byte hex string for PII encryption and deep-link signing
CLIENT_URL	Customer PWA base URL (e.g. https://app.neverline.fi)

Database Setup

Run migrations against your Supabase project:

supabase db push

Or apply migrations manually from supabase/migrations/.

Running Locally

# Start API server (port 3001)
pnpm --filter @neverline/api dev

# Start dashboard (port 5174)
pnpm --filter @neverline/dashboard dev

# Start customer PWA (port 5173)
pnpm --filter @neverline/client dev

# Start staff mobile app (Expo Metro Bundler)
pnpm --filter @neverline/mobile-access start