Bizmis Landing Site

The marketing site for Bizmis at bizmis.ai — landing page, pricing, FAQs, privacy policy, terms of service, and the asset/template generators for the outbound email campaigns.

This repo is not part of the Bizmis runtime — a standalone Vite + React site deployed independently to Vercel.

This README covers setup, scripts, and structure. For the Bizmis system context, see Landing Site (Notion). For the broader docs, see the Bizmis Docs hub on Notion.

---

Documentation

• Landing Site (Notion) — landing site's role in the Bizmis system.
• Bizmis Docs hub (Notion) — broader product, engineering, brand, marketing, and policy docs.
• Landing Page Copy & Structure (Notion) — single source of truth for landing copy + section structure (auto-generated from this repo via the retrieve-bizmis-landing-content skill).
• Landing FAQs (Notion) — canonical FAQs (auto-generated from src/data/faqs.ts via the retrieve-bizmis-faqs skill).

---

Canonical sources of truth in this repo

These files are the canonical source for content that appears on the live site and is referenced from the Bizmis docs hub:

Canonical content	Source file
Landing page copy + section structure	src/pages/Index.tsx (and src/components/)
Pricing tiers + Early Access coupon UI	src/components/Pricing.tsx
FAQs (questions, answers, categories)	src/data/faqs.ts
Privacy Policy text	src/pages/PrivacyPolicy.tsx
Terms of Service text	src/pages/Terms.tsx
Brand colors + constants	src/lib/bizmisBrandColors.ts

When any of these change, the corresponding Notion stub page automatically reflects the change via the retrieval skills — no manual sync needed.

---

Prerequisites

• Node.js 18+
• npm

---

Setup

npm install
npm run dev

The dev server runs at http://localhost:8080 (Vite default).

---

Scripts

Build / dev

Script	Description
npm run dev	Start Vite dev server with HMR.
npm run build	Production build.
npm run build:dev	Development-mode build.
npm run preview	Preview the production build locally.
npm run lint	Run ESLint.

Outbound funnel asset generators (local dev only)

These scripts power the Bizmis cold-outbound campaign assets (per-lead invite cards, early-access mockups, Instantly email templates). They all live in the sibling bizmis-skills repo and are wrapped here as npm script shortcuts that shell out to ../bizmis-skills/scripts/invite-cards/…. Production builds on Vercel do NOT run these — the lead loader in src/data/leads/index.ts auto-discovers any JSONs that exist locally and gracefully falls back to empty when bizmis-skills isn't checked out. See the Bizmis cold outbound funnel skills (Go-to-Market) for the full pipeline.

Script	Description
npm run sync:leads-to-landing	Copy per-lead JSONs from bizmis-skills/data/invite-cards/ into src/data/leads/.
npm run fetch:lead-early-access-assets	Fetch generated early-access assets per lead.
npm run generate:mock-lead-invite-assets	Generate per-lead mockup invite assets (PNG renders).
npm run generate:montage-waveform	Generate the waveform PNG used in support montages.
npm run generate:email-compositions	Generate composed email images.
npm run generate:instantly-template	Generate the Instantly email template HTML from the React invite-card source.
npm run generate:instantly-lead-fields	Generate the Instantly per-lead custom field set.

---

Project structure

├── src/
│   ├── pages/             # Route-level pages (Index, PrivacyPolicy, Terms, etc.)
│   ├── components/        # React components (Hero, Pricing, FAQs sections, etc.)
│   ├── data/              # Static data (faqs.ts, support-cases.ts, leads/, etc.)
│   ├── hooks/             # React hooks
│   ├── lib/               # Utilities + brand constants (bizmisBrandColors.ts)
│   └── styles/            # Global CSS
├── public/                # Static assets served as-is
├── email-templates/       # Output of the Instantly generator scripts (HTML + per-lead merge fields)
├── index.html             # Vite entry HTML
├── vite.config.ts         # Vite config
├── tailwind.config.ts     # Tailwind config
├── components.json        # shadcn/ui config
└── vercel.json            # Vercel rewrites + headers

Outbound funnel scripts and lead/asset data live in the sibling bizmis-skills repo (see scripts table above).

---

Tech stack

• Vite — build tool.
• React 18 + TypeScript.
• Tailwind CSS + shadcn/ui (Radix UI primitives).
• react-router-dom — client-side routing.
• @tanstack/react-query — server state.
• PostHog — product analytics.
• @emailjs/browser — contact form delivery.

---

Deployment

The site deploys to Vercel automatically on push to the production branch. vercel.json configures:

• Rewrites: SPA fallback — all routes serve index.html so client-side routing works.
• Headers: X-Robots-Tag: all to allow indexing.

The site is served at bizmis.ai (apex domain) and www.bizmis.ai.

---

Known issues

• Stale prerender in index.html — the deployed HTML ships a static prerender block that doesn't always match the live React render (e.g., it lists 10+ FAQ items when the live page filters / paginates). Tracked in BIZ-28. For agents querying landing content, use the retrieve-bizmis-landing-content and retrieve-bizmis-faqs skills (both read source files, not the prerendered HTML).
• Footer broken links — tracked in BIZ-26.