FlowLynks — marketing site (MVP)

Next.js + TypeScript + Tailwind. App code lives in this folder (web) inside FlowLynksFolder; strategy PDFs and plans stay in the parent folder or files/.

Run locally

1. Open a terminal.

2. Go to this app root:

   cd FlowLynksFolder/FlowLynks_Automation

   (Full path on this machine: c:\Users\USER\Andela\FlowLynksFolder\FlowLynks_Automation.)

3. Install dependencies (first time or after package.json changes):

   npm install

4. Optional: copy environment template and set the public site URL (used for sitemap, robots.txt, and Open Graph):

   copy .env.example .env.local

   On macOS/Linux: cp .env.example .env.local

   In .env.local, set e.g. NEXT_PUBLIC_SITE_URL=http://localhost:3000 while developing so /sitemap.xml and canonical URLs match your dev origin. In production, set it to your live domain (no trailing slash).

5. Start the dev server:

   npm run dev

6. Open the URL shown in the terminal (default http://localhost:3000).

Stop the server with Ctrl+C.

SEO (Step 3)

• Each route exports a unique title and meta description, plus canonical, Open Graph, and Twitter fields where relevant.
• /sitemap.xml and /robots.txt are generated from app/sitemap.ts and app/robots.ts.
• Default social preview image: app/opengraph-image.tsx (visit /opengraph-image while npm run dev is running to sanity-check).

Contact & booking (Step 4)

• Form: components/contact-form.tsx posts to app/api/contact/route.ts.
• Email (Resend): set RESEND_API_KEY, CONTACT_TO_EMAIL, and optionally RESEND_FROM_EMAIL (see Resend).
• Alternative (Formspree): set FORMSPREE_FORM_ID instead; the API forwards submissions server-side.
• Scheduler: set NEXT_PUBLIC_BOOKING_IFRAME_SRC to your Cal.com or Calendly iframe src URL for the embed on /contact.

If neither Resend nor Formspree is configured, the API returns 503 with a clear message (useful for local testing before keys exist).

Production build

npm run build
npm run start

Deploy (Vercel)

If the Git repository root is FlowLynksFolder, set the Vercel project Root Directory to web so builds use this package.json.

Stack

• Next.js
• TypeScript, ESLint, Tailwind CSS v4

No Clerk or other auth in the public marketing MVP unless a client portal is added later.