GrowBusinesss marketing site

The public website for GrowBusinesss, a WhatsApp marketing and sales SaaS for businesses in any country. It has:

• the marketing site (Home, Features, Pricing, Use cases, About, FAQ, Contact, legal pages) in English and Urdu (right to left);
• a guided query form (contact page and dialog) with spam protection, attachments and emails;
• a customer portal (/account) where people follow their queries and reply;
• a Super Admin area (/admin): dashboard, live inbox, replies, notes, saved replies, customers and settings.

The GrowBusinesss product itself is a separate app. Every "Start free trial" and "Sign in" link goes to NEXT_PUBLIC_APP_URL; this site never handles app accounts.

Standalone mode (before the app is live). Leave NEXT_PUBLIC_APP_URL and NEXTREACH_API_URL empty and the site works on its own: every "Start free trial" and plan button opens the query form (so each request lands in Admin → Queries), app sign-in links are hidden, and Pricing shows your plans from content/fallback-plans.ts with no warning. When the app launches, set both variables on Vercel and redeploy; no code changes are needed.

Stack: Next.js 16 (App Router, Cache Components, Server Actions), React 19, TypeScript (strict), Tailwind CSS v4 + shadcn/ui, Motion, next-intl, Supabase (Auth, Postgres + RLS, Storage, Realtime), Zod + React Hook Form, Resend, Vitest and Playwright.

---

Contents

1. Run it locally
2. Environment variables
3. Supabase setup
4. Make yourself a Super Admin
5. Email, spam protection and analytics
6. Live pricing
7. Deploy to Vercel
8. Scripts
9. Testing and quality checks
10. Project structure and conventions
11. Security notes
12. Troubleshooting

---

1. Run it locally

Requirements: Node.js 22.12 or newer (.nvmrc pins 24, the current LTS) and npm 10+.

npm install
cp .env.example .env.local     # fill in what you have; see section 2
npm run dev                    # http://localhost:3000 → redirects to /en

Every variable is optional for browsing the marketing pages. Without Supabase, the query form, sign-in, the portal and the admin area show a friendly error. Without the pricing API, Pricing shows the fallback plans with a "prices may have changed" note.

2. Environment variables

Put real values in .env.local (never committed). .env.example lists every variable with a placeholder. On Vercel, set the same names under Project → Settings → Environment Variables.

This is the beginning of the README. Read the rest at the original. Read the full README ↗