# Fuerte (Fusion Starter)

> A production-ready full-stack React application for vehicle dealership management, featuring inventory tracking, comparison tools, and lead management.

## Tech Stack
- **Frontend**: React 18 (SPA), React Router 6, TypeScript, Vite, TailwindCSS 3, Radix UI.
- **Backend**: Express.js server.
- **Database**: PostgreSQL (pg).
- **Tooling**: PNPM, Vitest, Zod, Framer Motion.

## Documentation
- [Full Documentation](/llms-full.txt): Comprehensive technical guide including data models and API signatures.

## Core Features
- Dynamic vehicle inventory with detailed specifications.
- Side-by-side vehicle comparison tool.
- Integrated credit calculator.
- Contact and test drive booking system.
- Secure Admin dashboard for inventory and lead management.
- SEO optimized with JSON-LD structured data.

## Project Structure
- `/client`: React SPA frontend.
  - `/pages`: Route components (e.g., Index, VehicleDetail, Admin).
  - `/components`: UI and domain-specific components.
  - `/lib`: API client, utility functions, and sample data.
- `/server`: Express API backend.
  - `/routes`: API handlers.
  - `db.ts`: Database configuration and schema.
- `/shared`: Shared TypeScript interfaces and utility types.
- `/public`: Static assets and uploaded media.

## Primary Routes
- `/`: Home page with featured vehicles.
- `/vehicles`: Catalog with search and filtering.
- `/vehicles/:id`: Detailed view of a specific vehicle.
- `/compare`: Side-by-side comparison tool.
- `/faq`: Frequently Asked Questions.
- `/contact`: Contact information and inquiry form.
- `/partners`: List of business partners and financing options.
- `/admin`: Secure management dashboard.

## Key API Endpoints
- `GET /api/vehicles`: Listing of all vehicles with filter support.
- `GET /api/vehicles/:id`: Detailed data for a specific vehicle.
- `POST /api/contact`: Submission endpoint for inquiries.
- `GET /api/partners`: Data source for the partners page.
- `GET /api/sync-status`: Real-time status of external inventory sync.

## Development Commands
- `pnpm dev`: Start both client and server in development mode.
- `pnpm build`: Build the application for production.
- `pnpm test`: Run the test suite.
- `pnpm typecheck`: Run TypeScript validation.

## Documentation
- [llms-full.txt](/llms-full.txt): Detailed documentation including domain models and architecture details.