Trovo — Quick Start

01Prerequisites

Get the code — unzip the download (or clone your repo) and cd into it.
Install dependencies
```
pnpm install
```
Configure environment — copy the example and fill in values (see §3).
```
cp .env.example .env.local
```
Apply the database schema
```
pnpm db:migrate
```
Start the dev server
```
pnpm dev
```
Open the app — visit http://localhost:3000.
Sign in with a demo account (below) and generate a first AI itinerary or browse the marketplace.

Required to boot: DATABASE_URL, AUTH_SECRET (≥16 chars), ENCRYPTION_KEY (64 hex chars), plus one of OPENAI_API_KEY / GOOGLE_AI_API_KEY.

Variable	Purpose
`DATABASE_URL`	Neon PostgreSQL connection string
`AUTH_SECRET` / `AUTH_URL`	NextAuth secret + base URL
`ENCRYPTION_KEY`	64 hex chars — `node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"`
`OPENAI_API_KEY` / `GOOGLE_AI_API_KEY`	AI provider (at least one)
`NEXT_PUBLIC_GOOGLE_MAPS_API_KEY` / `GOOGLE_MAPS_API_KEY`	Maps JS + Geocoding
`STRIPE_*`	Payments + subscriptions
`PAYPAL_*`	Optional second payment method
`R2_*`	Listing photo uploads
`RESEND_API_KEY`	Email (stub-logs without it)

Full descriptions: .env.example and the Environment Variables section in index.html.

Full production playbook (credential rotation, payment go-live, webhooks): docs/DEPLOY.md.

Create products/prices: Pro $9/mo + $89/yr, Business $29/mo + $290/yr, Lifetime $199. Set the 5 STRIPE_PRICE_* ids.
Add a webhook at /api/webhooks/stripe with 6 events: checkout.session.completed, charge.refunded, customer.subscription.created/updated/deleted, invoice.payment_failed. Copy the secret to STRIPE_WEBHOOK_SECRET.
Local: stripe listen --forward-to localhost:3000/api/webhooks/stripe.

Set PAYPAL_CLIENT_ID / PAYPAL_CLIENT_SECRET (+ public id).
Run pnpm paypal:setup to create the catalog product + 4 Plan IDs (no dashboard UI for this).
Add a webhook at /api/webhooks/paypal and set PAYPAL_WEBHOOK_ID.

Brand colors → tokens in app/globals.css (or white-label from the admin panel)
App name/logo → admin panel + NEXT_PUBLIC_APP_NAME
Plan limits → lib/plans.ts; pricing → lib/subscription-plans.ts
AI provider → toggle OpenAI/Gemini in admin settings

Issue	Fix
App won't start / env error	`DATABASE_URL`, `AUTH_SECRET`, or `ENCRYPTION_KEY` missing/invalid. `ENCRYPTION_KEY` must be exactly 64 hex chars.
Map shows `RefererNotAllowedMapError`	Add your domain (and `localhost`) to the public Maps key's HTTP-referrer restriction, and enable the Maps JavaScript API.
AI not responding	No valid `OPENAI_API_KEY` / `GOOGLE_AI_API_KEY`, or the per-user rate limit (10/hr) was hit.
Stripe webhook signature failure	`STRIPE_WEBHOOK_SECRET` doesn't match the endpoint. Re-copy it (CLI prints a different secret than the dashboard).
First build: "Can't reach database server"	Neon auto-suspended and cold-started. Retry / redeploy — it succeeds once the DB is awake.
Emails not sending	No `RESEND_API_KEY` set → email is stub-logged to the console. Add a key to send for real.
PayPal subscription button missing	The `PAYPAL_PLAN_*` ids are unset. Run `pnpm paypal:setup` and paste them in.

Stuck on setup? Reach out — we're glad to help.