Trovo

01Overview

Trovo is a production-ready travel platform. It combines an AI itinerary generator, a multi-vendor tour marketplace, subscription billing (Stripe + PayPal), and a full admin panel — all in a single Next.js 16 app.

Buyers deploy it three ways (or all at once):

What you get: full TypeScript source, this documentation + a quick-start guide, an admin panel, a provider portal, a marketing landing page, realistic demo content, and a Vercel deployment guide.

Live demo: trovo.devsnack.dev

02Features

03Architecture

Project structure

app/          Next.js App Router — public, dashboard, admin, provider, API
components/   shadcn/ui-based UI components
lib/          Shared utilities & service clients (ai, plans, auth, paypal, …)
prisma/       schema.prisma + migrations
emails/       React Email templates
docs/         PRD, launch, Stripe & deploy playbooks
proxy.ts      Route protection (Next 16's renamed middleware)

Route protection (proxy.ts): /dashboard/* requires auth, /provider/* requires a verified provider, /admin/* requires admin/moderator (and /admin/settings|billing|languages require admin only).

04Database Setup

Trovo uses Neon PostgreSQL (serverless) with Prisma ORM — no extensions or pgvector required. The schema has ~30 models grouped by domain:

cp .env.example .env.local   # then fill DATABASE_URL etc.
pnpm db:migrate              # create + apply schema (or db:push for prototyping)
pnpm db:studio               # browse the database

05AI Provider Setup

Trovo ships with two AI providers, admin-switchable at runtime via AdminSetting.ai_provider (factory in lib/ai.ts):

• OpenAI GPT-4o — default. Get a key at platform.openai.com.
• Google Gemini 1.5 Pro — alternate. Get a key at aistudio.google.com.

At least one of OPENAI_API_KEY / GOOGLE_AI_API_KEY is required. Free-plan users get gpt-4o-mini; Pro/Business get gpt-4o.

06Google Maps Setup

In the Google Cloud Console, enable both APIs:

• Maps JavaScript API — client-side map render
• Geocoding API — server-side place → lat/lng

Create two restricted keys (or reuse one):

• GOOGLE_MAPS_API_KEY — server key, IP-restricted, Geocoding only
• NEXT_PUBLIC_GOOGLE_MAPS_API_KEY — public key, HTTP-referrer-restricted, Maps JS only

Optional: create a custom Map Style and set NEXT_PUBLIC_GOOGLE_MAPS_MAP_ID for a branded dark map (required for Advanced Markers; falls back to legacy markers when empty).

07Authentication Setup

Auth is NextAuth v5 with email/password credentials and optional Google OAuth.

• Set AUTH_SECRET (openssl rand -base64 32) and AUTH_URL.
• Google sign-in: set GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET and add redirect URI <url>/api/auth/callback/google. Leave empty to hide the button.
• Verify-email and password reset are delivered via Resend.

08Payments Setup

Stripe

• Create products/prices: Pro $9/mo + $89/yr, Business $29/mo + $290/yr, Lifetime $199 (one-time). Set the five STRIPE_PRICE_* ids.
• Create a webhook at /api/webhooks/stripe subscribed to these 6 events:

checkout.session.completed     customer.subscription.created
charge.refunded                customer.subscription.updated
invoice.payment_failed         customer.subscription.deleted

Copy the signing secret into STRIPE_WEBHOOK_SECRET. Signatures are verified before any DB write. Local testing:

stripe listen --forward-to localhost:3000/api/webhooks/stripe

PayPal

PayPal supports bookings (Orders API) and recurring subscriptions (Billing Subscriptions API); Lifetime stays Stripe-only. There is no dashboard UI for subscription plans — run the bundled script:

pnpm paypal:setup     # creates the catalog product + 4 Plan IDs

Create a webhook at /api/webhooks/paypal (event list in .env.example) and set PAYPAL_WEBHOOK_ID. Set PAYPAL_ENV=live and re-run paypal:setup for production (sandbox Plan IDs don't work live).

09Image Uploads (Cloudflare R2)

Listing photos upload to Cloudflare R2; the server generates WebP variants with sharp.

• Create a bucket, enable the R2.dev public subdomain, copy the public URL into R2_PUBLIC_URL.
• Create an Object Read & Write API token; set R2_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY, R2_BUCKET_NAME.

10Email Setup

Transactional + campaign email is sent via Resend (React Email templates). Used for booking confirmations, verify-email, password reset, newsletter campaigns, and trip-edit notifications.

• Set RESEND_API_KEY and EMAIL_FROM. Without a key, email stub-logs to the console.
• Optional: set RESEND_WEBHOOK_SECRET + endpoint /api/webhooks/resend for newsletter open/click tracking.

11Environment Variables

All env vars are declared and validated with Zod in lib/env.ts; .env.example mirrors it with inline setup notes.

12Costs & Third-Party Services

At minimum Trovo needs three services — a PostgreSQL database, one AI provider key, and a Google Maps key. Everything else is optional and can be left disabled.

13Customization Guide

Most of Trovo can be rebranded and managed without touching code, from the admin panel. Sign in with an admin account and open Admin → Settings or Admin → Branding. Changes apply at runtime — no redeploy needed.

1 · Site name, tagline & support email

• Go to Admin → Settings.
• Set your Site name and Tagline.
• Set the Support email shown to customers, then Save.

2 · Logos & favicon

• Go to Admin → Branding.
• Upload your light logo (for dark backgrounds), dark logo (for light backgrounds), favicon, footer logo, and PDF logo.
• Each upload instantly replaces the Trovo default across the site, emails, and exported PDFs.

3 · Brand colors

• Go to Admin → Settings → Branding.
• Pick your Primary color (buttons, links, accents) and Accent color (highlights) as hex values.
• Save — the whole interface re-themes immediately.

4 · Social links & footer

• In Admin → Branding, add your X/Twitter, Instagram, Facebook, LinkedIn, and YouTube handles or URLs (blank ones are hidden).
• Set the Footer brand text (e.g. your copyright line).

5 · Content — all editable in the admin panel

• Blog — write posts in Admin → Blog with a rich-text editor.
• Legal pages — edit Terms & Privacy in Admin → Legal.
• Announcements — show a site-wide banner from Admin → Announcements.
• Plans, pricing & commission — see Managing Your Platform below.

14Managing Your Platform

The admin panel at /admin is where you run the business day to day. Sign in with an Admin account. Here's each area and what it's for:

Common tasks

• Choose your AI provider & add keys: Admin → Settings → pick OpenAI or Gemini and paste your key (stored encrypted at rest).
• Approve a provider: Admin → Providers → open the application → Verify.
• Set your commission: Admin → Settings → marketplace commission (default 15%).
• Take the site offline for maintenance: Admin → Settings → toggle maintenance mode.

Roles at a glance

15Deployment

Trovo is built for Vercel.

• Import the repo at vercel.com/new (Next.js auto-detected; build pnpm build).
• Set all env vars (including NEXT_PUBLIC_* before the build).
• Apply the schema against the production DB: prisma migrate deploy.
• Deploy.

16Production Checklist

17Subscription Plans

18Frequently Asked Questions

Does the purchase price include API and service costs?

No. You're buying the Trovo source code. AI (OpenAI / Gemini), Google Maps, payment processing, hosting, storage, and email run on your own accounts and are billed to you — see Costs & Third-Party Services. Most offer a free tier to start.

Can I turn off the AI features?

Yes. AI itineraries are optional. Without an AI key the planner is hidden and the rest of the platform — marketplace, bookings, content — works normally.

Can I run Trovo without Stripe / PayPal?

Yes. Leave the payment keys blank and checkout and subscriptions stay disabled. You can run Trovo as a pure trip planner or a free tour directory.

How do providers (vendors) get paid?

In v1.0 payouts are handled manually by the admin. Trovo tracks each provider's earnings minus your commission in Admin → Payouts; you pay them out via your own method. Automated instant payouts (Stripe Connect) are not part of v1.0.

What's the difference between Admin and Moderator?

Admins have full access including the restricted Settings area (API keys, commission, maintenance mode). Moderators handle day-to-day moderation — users, listings, bookings, reviews, content — but can't change platform settings.

How many users, listings, or providers can it handle?

There's no built-in cap — it scales with your database and hosting plan. The Free / Pro / Business plans only gate end-user features (AI usage, collaborators, and so on), not platform totals.

Is white-label / rebranding included?

Yes. Change the name, logos, colors, social links, and footer from the admin panel with no code — see the Customization guide.

Can I change subscription prices and plan limits?

Yes. Plan pricing and feature gates live in lib/subscription-plans.ts and lib/plans.ts; the payment products themselves are configured in your Stripe / PayPal dashboards.

Does it run on Windows?

You can develop on Windows, macOS, or Linux (Node 20+ and pnpm). Production runs on any Node host; Vercel is the documented target.

What support is included?

Setup help and bug fixes by email — devsnack26@gmail.com. Custom feature development isn't included.

19Changelog

20Support