# Park Your Pup - LLM-Optimized Documentation
# https://parkyourpup.replit.app/llms.txt
# Last Updated: 2026-01-29

## Overview
Park Your Pup is a premium pet boarding application offering hourly services, live monitoring, and a comprehensive gamification system.

## Core Philosophy
- "Premium Care, Real-Time Connection" - High-end pet services with transparency.
- "Gamified Pet Care" - Paw Points system to reward engagement and loyalty.
- "White-Label Ready" - Multi-location and B2B capability built into the core.

## Technical Architecture
- Frontend: React 18, Vite, Tailwind CSS, Wouter, TanStack Query, Framer Motion.
- Backend: Node.js (Express), TypeScript, WebSocket (ws).
- Database: PostgreSQL (Neon) with Drizzle ORM.
- Auth: Replit Auth integration.

## Key Features
1. Live Camera System: Real-time HD feeds with viewer tracking.
2. Booking Engine: Flexible hourly/daily/monthly boarding with add-on services.
3. Paw Points System: Integrated gamification across booking, games, and store.
4. Business Dashboard: Analytics for revenue, services, and multi-location management.
5. Service Catalog: Categorized services (Grooming, Therapy, Luxury, etc.) with location overrides.

## User Roles
- user: Standard customer with pet profiles and bookings.
- admin: Business owner with access to analytics and service management.
- manager: Facility manager with location-specific controls.
- staff: Role-based access (groomer, trainer, caregiver).

## API Routes
- /api/services - Catalog management.
- /api/subscriptions - Tiered membership handling.
- /api/points - Gamification balance and history.
- /api/facilities - Multi-location management.
- /api/analytics - Business metrics.

## Contact
- Support: support@parkyourpup.replit.app
- Terms: /terms
- Privacy: /privacy