Glint Host Registry

Professional compliance operations SaaS for EU short-term rental hosts under Regulation (EU) 2024/1028.

Going live? See GO_LIVE.md for the production billing checklist (Stripe live flip, smoke tests, rollback).

Stack

• Next.js 16 (App Router) + TypeScript + Tailwind CSS
• Prisma 7 + SQLite (local/demo) — Postgres/Turso-ready
• Auth.js (NextAuth v5) — email/password credentials; optional Google OAuth when configured
• next-intl — bilingual FR/EN UI
• Stripe — subscription billing (test mode until go-live; see GO_LIVE.md)

Quick start

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env
# Edit .env — at minimum set AUTH_SECRET (openssl rand -base64 32)

# Run database migrations
npm run db:migrate

# Start dev server
npm run dev

Open http://localhost:4311

Environment variables

See .env.example for the full list. Summary:

Target	Stripe keys	Notes
Local / Preview	sk_test_ / pk_test_	Safe for development and PR previews
Production	sk_live_ / pk_live_	Live billing active (see GO_LIVE.md); keep SES_LIVE=false
Preview	sk_test_ / pk_test_	Safe for PR previews and QA

Variable	Required	Description
DATABASE_URL	Yes	SQLite path (file:./dev.db) or Turso/libsql URL
AUTH_SECRET	Yes	Auth.js session secret
AUTH_GOOGLE_ID	Optional	Shared Glint Google OAuth client ID (enables Google sign-in when paired with secret)
AUTH_GOOGLE_SECRET	Optional	Google OAuth client secret
EMAIL_FROM	For password reset	Sender address (e.g. Glint Host <[email protected]>)
RESEND_API_KEY	For password reset	Resend API key (preferred mailer when set)
SMTP_HOST	For password reset	SMTP host when not using Resend
SMTP_PORT	Optional	SMTP port (default 465, TLS when 465)
SMTP_USER / SMTP_PASS	Optional	SMTP credentials when required by your provider
EMAIL_REPLY_TO	Optional	Reply-To header on transactional email
DEMO_LOCKED_EMAILS	Optional	Comma-separated emails blocked from self-serve password reset
NEXT_PUBLIC_APP_URL	Yes	Public app URL for Stripe redirects and reset links
STRIPE_SECRET_KEY	For billing	Stripe secret key (test: sk_test_...)
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY	For billing	Stripe publishable key
STRIPE_PRICE_STARTER	For billing	Price ID for Starter plan (€19/mo)
STRIPE_PRICE_PRO	For billing	Price ID for Pro plan (€49/mo)
STRIPE_WEBHOOK_SECRET	For billing	Webhook signing secret
CRON_SECRET	Production

Stripe setup (test mode)

1. Create a Stripe account (test mode).
2. Create two Products with recurring monthly prices in EUR:
   • Starter — €19/month (up to 3 properties)
   • Pro — €49/month (up to 50 properties)
3. Copy each Price ID (price_...) to STRIPE_PRICE_STARTER and STRIPE_PRICE_PRO.
4. Copy API keys from Developers → API keys.
5. For local webhook testing:

   stripe listen --forward-to localhost:4311/api/stripe/webhook
   

   Copy the webhook signing secret to STRIPE_WEBHOOK_SECRET.
6. Enable Customer Portal in Stripe Dashboard → Settings → Billing → Customer portal.

Scripts

Command	Description
npm run dev	Dev server on port 4311
npm run build	Production build
npm run start	Production server
npm run db:migrate	Run Prisma migrations
npm run db:studio	Open Prisma Studio
npm run test	Run unit tests (SES, Spain/Italy/Portugal/Greece/Croatia routing, export validation, guest-reporting router, encryption)
npm run verify-playbook-urls	HTTP 200 check for verified playbook official URLs
npm run test:ses	Run SES integration unit tests only

Deploy on Vercel

1. Push to GitHub and import in Vercel.
2. Set all env vars from .env.example (Preview: test Stripe; Production: see GO_LIVE.md).
3. For production database, use Turso or Vercel Postgres:
   • Turso: DATABASE_URL="libsql://your-db.turso.io" + TURSO_AUTH_TOKEN
   • Run migrations: npx prisma migrate deploy
4. Configure Stripe webhook endpoint: https://your-domain.com/api/stripe/webhook
5. Set NEXT_PUBLIC_APP_URL to your production URL.
6. Set CRON_SECRET and SECRETS_ENCRYPTION_KEY on Production — crons in vercel.json: iCal sync (04:00 UTC daily), SES due (08:00 UTC daily).

Project structure

src/
  app/
    [locale]/           # i18n routes (en, fr)
      page.tsx          # Marketing landing
      login/ signup/    # Auth pages
      app/              # Protected dashboard
      legal/            # Privacy, Terms, Mentions
      export/[id]/      # Printable compliance summary
    api/                # API routes
  components/           # UI components
  lib/                  # Auth, Prisma, Stripe, compliance logic
  i18n/                 # next-intl config
messages/               # en.json, fr.json
prisma/                 # Schema + migrations

See PRODUCT.md for product documentation.

SEO

Glint Host Registry ships with production-ready technical SEO:

• Favicon & social cards — generated icon, apple-icon, and opengraph-image (not Next.js defaults)
• Locale metadata — FR/EN titles, descriptions, canonical URLs, and hreflang alternates on marketing pages
• Structured data — JSON-LD (Organization, WebSite, SoftwareApplication, FAQPage) on the landing page
• Crawl controls — /robots.txt and /sitemap.xml; /app/*, check-in tokens, exports, and print views are noindex
• Host guides — public /[locale]/guides/... pages linked from the footer

Search Console (next step for Benjamin)

1. Open Google Search Console and add the property https://glint-host-registry.vercel.app.
2. Verify ownership (DNS or HTML tag via Vercel).
3. Submit the sitemap: https://glint-host-registry.vercel.app/sitemap.xml
4. Inspect a few URLs (/fr, /en, guide pages) to confirm indexing and hreflang.
5. No paid ads required — organic discovery only.

Set NEXT_PUBLIC_APP_URL to the production URL so canonical and OG URLs resolve correctly.