# UpCountry Rideshare Platform - LLM Context

## Project Overview
UpCountry is a rideshare platform built for Kenya, connecting passengers with drivers for safe and reliable transportation. The platform includes contact forms, comprehensive safety features, and support resources.

## Business Description (SEO Context)
UpCountry provides safe, affordable rideshare services across Kenya, connecting local drivers with passengers traveling between cities and towns. Our platform emphasizes safety, reliability, and community-focused transportation solutions for Kenyan travelers.

## Tech Stack
- **Frontend**: Next.js 15.3.2 with App Router, React 19, TypeScript
- **Styling**: CSS Modules with custom variables
- **Icons**: Lucide React
- **Search**: Fuse.js for fuzzy search
- **Deployment**: Vercel (implied from analytics)

## Key Directories Structure

### `/app` - Next.js App Router Pages
- `/contact` - Contact page with form
- `/safety` - Safety tips and guidelines
- `/support` - Support hub with FAQs

### `/components` - Reusable UI Components
- Hero, features, contact form, safety tips, footer, header, etc.
- All styled with CSS Modules

### `/public` - Static Assets
- Images, PDF worker, robots.txt, sitemap.xml, LLM.txt

## Important Files
- `package.json` - Dependencies and scripts
- `next.config.ts` - Next.js configuration
- `tsconfig.json` - TypeScript configuration
- `README.md` - Project documentation

## Key Features
1. **Safety Features**: Detailed safety tips with illustrations and guidelines
2. **Contact System**: Contact form with categories and validation
3. **SEO Optimized**: Full metadata, schemas, sitemap, robots.txt
4. **Responsive Design**: Mobile-first CSS with dark theme support
5. **Support Hub**: FAQ system with search functionality

## Development Setup
1. Install dependencies: `npm install`
2. Run dev server: `npm run dev`
3. Build for production: `npm run build`

## Recent Changes (as of Oct 31, 2025)
- Full SEO implementation with metadata API
- Structured data (JSON-LD schemas)
- robots.txt and sitemap.xml added
- Contact page metadata enhanced
- Safety page with HowTo schema
- Support page with FAQ schema

## Notes for AI Assistants
- Use CSS Modules for styling (scoped classes)
- All pages use metadata API for SEO
- Components are modular and reusable
- TypeScript is used throughout for type safety

## Common Patterns
- Async functions for API calls
- useState/useEffect for React state management
- CSS custom properties for theming
- Form validation with controlled components

## Key Directories Structure

### `/app` - Next.js App Router Pages
- `/contact` - Contact page with form
- `/safety` - Safety tips and guidelines
- `/support` - Support hub with FAQs

### `/components` - Reusable UI Components
- Hero, features, contact form, safety tips, footer, header, etc.
- All styled with CSS Modules

### `/public` - Static Assets
- Images, PDF worker, robots.txt, sitemap.xml, LLM.txt

## Important Files
- `package.json` - Dependencies and scripts
- `next.config.ts` - Next.js configuration
- `tsconfig.json` - TypeScript configuration
- `README.md` - Project documentation

## Key Features
1. **Safety Features**: Detailed safety tips with illustrations and guidelines
2. **Contact System**: Contact form with categories and validation
3. **SEO Optimized**: Full metadata, schemas, sitemap, robots.txt
4. **Responsive Design**: Mobile-first CSS with dark theme support
5. **Support Hub**: FAQ system with search functionality

## Development Setup
1. Install dependencies: `npm install`
2. Run dev server: `npm run dev`
3. Build for production: `npm run build`

## Recent Changes (as of Oct 31, 2025)
- Full SEO implementation with metadata API
- Structured data (JSON-LD schemas)
- robots.txt and sitemap.xml added
- Contact page metadata enhanced
- Safety page with HowTo schema
- Support page with FAQ schema

## Notes for AI Assistants
- Use CSS Modules for styling (scoped classes)
- All pages use metadata API for SEO
- Components are modular and reusable
- TypeScript is used throughout for type safety

## Common Patterns
- Async functions for API calls
- useState/useEffect for React state management
- CSS custom properties for theming
- Form validation with controlled components