tyler/route-commerce
1
0
Fork 1
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity
Files
95eab42f4bffafa072d1d2e7bb7f0164be1e6e58
route-commerce/LAUNCH_CHECKLIST.md
T
Nora 95eab42f4b docs: refresh stale docs to match current implementation 
Documentation pass — reviewed codebase in full, identified stale references,
and aligned docs with actual code state.

Changes:
- CLAUDE.md, PRODUCTION_SETUP.md, LAUNCH_CHECKLIST.md, src/auth.config.ts:
  middleware path src/middleware.ts → src/proxy.ts (Next.js 16+ convention)
- CLAUDE.md, ENVIRONMENT.md, README.md:
  dev server port localhost:3000 → localhost:4000 (per package.json dev
  script 'next dev --webpack -H 0.0.0.0 -p 4000')
- PRODUCTION_DEPLOYMENT_CHECKLIST.md:
  rewrote migration list — actual db/migrations/ contains 10 files
  (0000–0091), not the Supabase-era 001–092 series. Updated platform
  version 1.6 → 2.0 and last-updated stamp.
- MEMORY.md:
  refreshed 'Last updated' to 2026-06-25, added current-state header
  flagging Auth.js v5 wiring as historical, and documented the SSH/Gitea
  workflow (id_ed25519_crispygoat + no API token → push-hook URL flow
  for opening PRs).
- LAUNCH_CHECKLIST.md:
  added 'Last updated: 2026-06-25' header and refresh note in footer.
- CLAUDE.md:
  new 'Gitea authentication (SSH)' subsection under 'Canonical Remote'
  documenting ~/.ssh/id_ed25519_crispygoat, ssh-agent setup, what works
  (git push) vs what doesn't (REST API without token), and the actual
  PR-creation workflow (push + open the URL the Gitea hook prints).

Verification:
- npx tsc --noEmit: pre-existing Stripe API version + test mock errors
  only (verified by stashing changes and re-running — same error set).
- No new errors introduced.
2026-06-25 20:18:49 -06:00

8.1 KiB
Raw Blame History

Route Commerce Launch Checklist Summary

Last updated: 2026-06-25

Overview

This document summarizes the complete Launch & Marketing Layer implementation for Route Commerce, a multi-tenant B2B e-commerce platform for fresh produce wholesale distribution.

✅ Implementation Status

1. Database & Auth Foundation ✓

Component Status Location
Auth Flow ✓ Complete Neon Auth (Better Auth) + dev_session for local
Database Structure ✓ Complete db/migrations/ applied via pg
Role-Based Access ✓ Complete admin-permissions.ts system
Protected Routes ✓ Complete src/proxy.ts (Next.js 16+ middleware convention)
Server Actions Pattern ✓ Complete src/actions/*.ts

2. Launch-Ready Features ✓

Feature Status Location
Landing Page ✓ Complete src/app/page.tsx, src/components/landing/
Hero Section ✓ Complete HeroSection.tsx with animations
Social Proof ✓ Complete FeaturesAndStats.tsx
Testimonials ✓ Complete TestimonialsAndCTA.tsx
Waitlist Signup ✓ Complete src/app/api/waitlist/route.ts
Guided Product Tour ✓ Complete OnboardingFlow.tsx
Changelog ✓ Complete src/app/changelog/page.tsx
Referral Program ✓ Complete src/app/api/referrals/route.ts, ReferralSystem.tsx
Public Roadmap ✓ Complete src/app/roadmap/page.tsx

3. Marketing & Conversion ✓

Feature Status Location
Pricing Page ✓ Complete src/app/pricing/page.tsx
Monthly/Annual Toggle ✓ Complete PricingClientPage.tsx
Feature Comparison Table ✓ Complete PricingClientPage.tsx
Stripe Checkout Buttons ✓ Wired Existing checkout actions
Testimonials Carousel ✓ Complete TestimonialsAndCTA.tsx
SEO Optimization ✓ Complete Dynamic metadata, robots.ts, sitemap.ts
Open Graph Images ✓ Complete public/og-default.svg
Blog/Resources ✓ Complete src/app/blog/page.tsx
Email Capture ✓ Complete Newsletter form in blog page

4. Communications & Retention ✓

Feature Status Location
Harvest Reach Campaigns ✓ Complete Existing /admin/communications
Email Templates ✓ Complete Existing email-templates.ts
In-App Notifications ✓ Complete InAppNotificationCenter.tsx
Toast System ✓ Complete ToastNotification.tsx
Cookie Consent Banner ✓ Complete CookieConsentBanner.tsx
PWA Install Prompt ✓ Complete InstallPrompt.tsx

5. Analytics & Monitoring ✓

Feature Status Location
PostHog Integration ✓ Ready src/lib/analytics.ts (configurable)
Sentry Error Tracking ✓ Ready src/lib/sentry.ts (configurable)
Admin Analytics Dashboard ✓ Complete src/app/admin/analytics/page.tsx

6. Legal & Trust ✓

Feature Status Location
Privacy Policy ✓ Complete src/app/privacy-policy/page.tsx
Terms of Service ✓ Complete src/app/terms-and-conditions/page.tsx
Cookie Consent ✓ Complete CookieConsentBanner.tsx
Security Page ✓ Complete src/app/security/page.tsx
Trust Badges ✓ Complete SiteFooter.tsx

7. Final Polish ✓

Feature Status Location
404 Page ✓ Complete src/app/not-found.tsx
Maintenance Page ✓ Complete src/app/maintenance/page.tsx
PWA Manifest ✓ Complete public/manifest.json
Service Worker ✓ Complete public/sw.js
Launch Checklist ✓ Complete src/app/admin/launch-checklist/page.tsx

📁 Key Files Created

API Routes

  • src/app/api/referrals/route.ts - Referral code generation and tracking
  • src/app/api/waitlist/route.ts - Waitlist signup management
  • src/app/api/v1/referrals/route.ts - Public referral API

Pages

  • src/app/blog/page.tsx - Blog and resources section
  • src/app/changelog/page.tsx - Version history
  • src/app/roadmap/page.tsx - Public roadmap
  • src/app/privacy-policy/page.tsx - GDPR privacy policy
  • src/app/terms-and-conditions/page.tsx - Terms of service
  • src/app/security/page.tsx - Security information
  • src/app/maintenance/page.tsx - Maintenance mode page
  • src/app/admin/launch-checklist/page.tsx - Pre-launch checklist

Components

  • src/components/legal/CookieConsentBanner.tsx - GDPR cookie banner
  • src/components/referral/ReferralSystem.tsx - Referral UI
  • src/components/onboarding/OnboardingFlow.tsx - Welcome tour
  • src/components/pwa/InstallPrompt.tsx - PWA install prompt
  • src/components/notifications/InAppNotificationCenter.tsx - Notification bell

Static Assets

  • public/og-default.svg - Open Graph image
  • public/favicon.svg - SVG favicon
  • public/manifest.json - PWA manifest
  • public/sw.js - Service worker

Utilities

  • src/lib/analytics.ts - Analytics helpers
  • src/lib/sentry.ts - Sentry configuration
  • eslint.config.mjs - Updated ESLint config

🚀 Go-to-Market Steps

Pre-Launch Checklist (32 items across 8 categories)

  1. Account & Access (~5 min)

    • Create admin accounts for all team members
    • Enable 2FA for all admin accounts
    • Set up role-based permissions

  2. Billing & Payments (~10 min)

    • Connect Stripe account
    • Review all plan pricing is correct
    • Test invoice generation

  3. Products & Catalog (~30 min)

    • Import products to catalog
    • Set wholesale pricing
    • Upload product images
    • Organize categories

  4. Communication (~15 min)

    • Configure Resend for email delivery
    • Review email templates
    • Set up welcome email sequence

  5. Legal & Compliance (~15 min)

    • Confirm privacy policy is live
    • Confirm terms of service is live
    • Verify cookie consent banner works
    • Review security page content

  6. Marketing & SEO (~20 min)

    • Set up PostHog analytics
    • Submit sitemap to Google Search Console
    • Create social sharing images
    • Set up social media profiles

  7. Testing & QA (~30 min)

    • Complete end-to-end checkout test
    • Test login, signup, password reset
    • Check all pages on mobile
    • Verify transactional emails arrive

  8. Infrastructure (~10 min)

    • Configure custom domain
    • Verify HTTPS is working
    • Confirm database backups enabled
    • Set up uptime monitoring

Environment Variables Required

# Analytics (optional - disable if not configured)
NEXT_PUBLIC_POSTHOG_API_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com

# Error Tracking (optional - disable if not configured)
SENTRY_DSN=

# Email (required for communications)
RESEND_API_KEY=

# Site URL
NEXT_PUBLIC_SITE_URL=https://yourdomain.com

Deployment Checklist

  1. Push code to GitHub
  2. Connect Vercel project
  3. Set environment variables in Vercel dashboard
  4. Configure custom domain
  5. Set up Stripe webhook (/api/stripe/webhook)
  6. Test production checkout flow
  7. Submit sitemap to Google Search Console
  8. Enable PostHog capture (if configured)

📊 Success Metrics

Track these metrics post-launch:

Metric Target
Monthly Recurring Revenue (MRR) $X,XXX
Active Brands XX
Orders Processed XXX/month
Email Open Rate >25%
Checkout Conversion >3%
Churn Rate <5%

🔗 Important Links

Resource URL
Landing Page /
Pricing /pricing
Blog /blog
Changelog /changelog
Roadmap /roadmap
Waitlist /waitlist
Admin Dashboard /admin
Launch Checklist /admin/launch-checklist

📞 Support

Generated: January 2025 · Refreshed: 2026-06-25 (see CLAUDE.md for current architecture; deployment is via Vercel hooked to the Gitea origin remote — there is no GitHub origin)

Reference in New Issue View Git Blame Copy Permalink