Reliant AI Website

Marketing SPA for Reliant AI — built with React 19, TypeScript, Vite, Tailwind CSS, GSAP animations, and Three.js 3D.

Quick Start

npm install
cp .env.example .env.local   # add your Web3Forms key
npm run dev

Environment Variables

Variable	Required	Description
VITE_WEB3FORMS_KEY	Yes	Web3Forms API key for contact/audit forms. Get one at web3forms.com.

Scripts

Command	Description
npm run dev	Start dev server with HMR
npm run build	Type-check + production build
npm run build:verify	Verify the production bundle does not contain dev JSX/runtime artifacts
npm run lint	Run ESLint
npm run typecheck	Run TypeScript project checks
npm run preview	Preview production build locally
npm run quality:check	Run recurring quality loop checks and generate reports/quality/latest.md
npm run quality:fix	Apply safe lint autofixes

Stack

• Framework: React 19 + TypeScript (strict mode)
• Build: Vite 7 with manual chunk splitting (react, three, gsap, ui vendors)
• Styling: Tailwind CSS + Shadcn/ui components
• Animations: GSAP + ScrollTrigger, Three.js via React Three Fiber
• Forms: React Hook Form + Zod validation → Web3Forms
• Deployment: Vercel (SPA rewrites + security headers configured)

Project Structure

src/
├── components/   # Reusable UI components (Navigation, popups, 3D, etc.)
├── sections/     # Page sections composed in App.tsx
├── hooks/        # Custom hooks (useTheme, useScrollReveal, usePopupTrigger)
├── lib/          # Shared utilities (web3forms.ts)
├── data/         # Static data (case study chapters)
└── pages/        # Route pages (Privacy, ToS, 404)

Deployment

The site deploys automatically to Vercel on push to main. All security headers (HSTS, CSP, X-Frame-Options, etc.) are configured in vercel.json. Add VITE_WEB3FORMS_KEY as a Vercel environment variable before deploying.

Continuous Quality Loop

• Automated workflow: .github/workflows/quality-loop.yml
• Cadence:
  • Daily quality checks (lint/build/audit/dependency drift)
  • Weekly extended maintenance run
• Local run:

npm run quality:check

Each run writes a report to reports/quality/latest.md and uploads it as a GitHub Actions artifact.