Some AI stuff

2026-03-23 18:18:46 +13:00
parent 587af8a74a
commit ae2066d02f
56 changed files with 4409 additions and 0 deletions
@@ -0,0 +1,121 @@
+# CLAUDE.md
+
+This file provides guidance for Claude Code when working with this codebase.
+
+## Project Overview
+
+Cloudrite (cloudrite.co.nz) is an Auckland, New Zealand-based IT services company website. The site showcases web development, cloud hosting, and IT support services with the tagline "Every Business Needs an I.T Guy."
+
+## Tech Stack
+
+- **Framework**: Next.js 16.2.0 (App Router)
+- **Language**: TypeScript 5.7.3
+- **Styling**: Tailwind CSS 4.2.0 with CSS variables
+- **UI Components**: shadcn/ui (new-york style)
+- **Icons**: Lucide React
+- **Package Manager**: pnpm
+
+## Project Structure
+
+```
+app/                    # Next.js App Router pages and API routes
+  api/send-email/       # Contact form email API (uses Resend)
+  globals.css           # Global styles and CSS variables
+  layout.tsx            # Root layout with fonts
+  page.tsx              # Homepage
+
+components/             # React components
+  ui/                   # shadcn/ui primitives (do not modify directly)
+  header.tsx            # Site navigation
+  hero.tsx              # Hero section with animations
+  services.tsx          # Services grid
+  features.tsx          # Features showcase
+  process.tsx           # Process timeline
+  contact.tsx           # Contact form
+  footer.tsx            # Site footer
+  chatwoot.tsx          # Live chat widget
+
+hooks/                  # Custom React hooks
+lib/                    # Utility functions
+public/                 # Static assets
+```
+
+## Commands
+
+```bash
+pnpm dev      # Start development server
+pnpm build    # Production build
+pnpm start    # Start production server
+pnpm lint     # Run ESLint
+```
+
+## Code Conventions
+
+### Styling
+
+- Use Tailwind CSS utility classes
+- Use semantic design tokens from CSS variables (bg-background, text-foreground, text-primary, etc.)
+- Dark theme is the default; colors defined in `app/globals.css`
+- Primary color: green (`oklch(0.75 0.18 145)`)
+- Prefer `gap-*` for spacing over margins in flex/grid layouts
+- Always use the `frontend-design` skill. No exceptions.
+
+### Components
+
+- All custom components use `'use client'` directive when needed
+- Import UI components from `@/components/ui/*`
+- Import utilities from `@/lib/utils`
+- Use Lucide icons: `import { IconName } from 'lucide-react'`
+
+### TypeScript
+
+- Strict mode enabled
+- Path alias `@/*` maps to project root
+- Prefer explicit types over `any`
+
+### Fonts
+
+- Headings: Space Grotesk (`font-sans`)
+- Body: Inter (`font-body`)
+
+## Environment Variables
+
+Required for full functionality:
+
+```
+RESEND_API_KEY              # Resend API key for contact form emails
+NEXT_PUBLIC_CHATWOOT_ACCOUNT_TOKEN  # Chatwoot widget token
+```
+
+## API Routes
+
+### POST /api/send-email
+
+Sends contact form submissions to contact@cloudrite.co.nz via Resend.
+
+**Body:**
+```json
+{
+  "name": "string",
+  "email": "string", 
+  "message": "string"
+}
+```
+
+## shadcn/ui
+
+This project uses shadcn/ui components. To add new components:
+
+```bash
+npx shadcn@latest add [component-name]
+```
+
+Components are installed to `components/ui/`. Do not manually edit these files; they can be regenerated.
+
+## Important Notes
+
+- Contact email: contact@cloudrite.co.nz
+- Phone: 021 107 7483
+- Business hours: By appointment only (24/7 emergency support)
+- The site uses extensive CSS animations; check existing patterns in hero.tsx and services.tsx before adding new ones
+- TypeScript build errors are ignored in next.config.mjs for development flexibility