# 💍 Lerato & Denver: The Forever Experience

A high-end, cinematic wedding platform built for Lerato Molema and Denver Moyo. This is not just a website; it is a digital concierge designed to provide a "Shock & Awe" experience for every guest, featuring frosted glassmorphism, real-time AI assistance, and immersive scroll-driven storytelling.

## 🌿 Design Language

The project follows a Garden Sanctuary aesthetic:
- **Palette:** Sage Hint (#BFCFBB), Mint (#BFCFBB), Sage (#8EA58C), Moss (#738A6E), and Evergreen (#344C3D)
- **Typography:** Great Vibes for elegant calligraphy and Inter for clean, modern legibility
- **Aesthetic:** High-density glassmorphism, botanical parallax, and liquid silver accents

## ✨ Key Features

1. **Cinematic Hero & Entrance** - Frosted calligraphy with mirror-frosted shadow and silver liquid shimmer
2. **AI Wedding Concierge** - Custom AI-driven chat system with semantic intelligence
3. **Immersive Journey Timeline** - Spring-physics vertical line with clickable milestones
4. **Advanced RSVP System** - Real-time deadline countdown, guest directory, style inspiration
5. **Digital Guest Pass** - Calendar sync, protected guest dashboard

## 🛠️ Tech Stack

- **Framework:** Next.js 16.1.1 (App Router)
- **Language:** TypeScript 5.x
- **UI Library:** React 19.2.1
- **Styling:** Tailwind CSS 4
- **Components:** Radix UI & Shadcn UI
- **Animation:** Framer Motion
- **Database:** PostgreSQL (via Prisma 7.2.0) + Supabase
- **Infrastructure:** Self-hosted on Proxmox or Vercel

## 📚 Documentation

**All documentation is now centralized in the `docs/` directory.**

- **[Documentation Index](docs/DOCS_INDEX.md)** - Complete guide to all documentation
- **[Single Source of Truth (SSOT)](docs/SSOT.md)** - Comprehensive documentation covering:
  - Overview & Architecture
  - Local Development Setup
  - Environment Configuration
  - Database & Supabase Setup
  - Deployment (Proxmox)
  - Troubleshooting
  - Operations & Runbooks

**Quick Links:**
- [Getting Started](docs/SSOT.md#local-development-setup) - Local development setup
- [Environment Variables](docs/SSOT.md#environment-configuration) - Complete environment variable reference
- [Deployment Guide](docs/SSOT.md#deployment-proxmox) - Production deployment to Proxmox
- [Troubleshooting](docs/SSOT.md#troubleshooting) - Common issues and solutions

## 🚀 Quick Start

For detailed setup instructions, see [Local Development Setup](docs/SSOT.md#local-development-setup) in the SSOT.

**Basic steps:**
1. Clone the repository
2. Install dependencies: `npm install`
3. Set up environment variables (see [Environment Configuration](docs/SSOT.md#environment-configuration))
4. Run development server: `npm run dev`

## 🥂 The Vow

> "To build a digital experience as timeless and beautiful as the love it celebrates."

---

**For complete documentation, see [docs/DOCS_INDEX.md](docs/DOCS_INDEX.md)**