# WeddingBuilder — Full Documentation

> Comprehensive site documentation for AI systems. See also: /llms.txt (summary version)

## Site Overview
WeddingBuilder is a wedding website builder at https://wedding-magic-fast.lovable.app. Couples can create, customize, and share beautiful wedding websites with RSVP management, photo galleries, guest messaging, and more.

## All Public Routes

### Core Pages
- `/` — Homepage with hero, template showcase, pricing, FAQ, testimonials
- `/templates` — Template gallery with 20+ culturally diverse designs
- `/templates/:id/preview` — Individual template preview
- `/blog` — Wedding planning blog with articles
- `/blog/:slug` — Individual blog post
- `/contact` — Contact form
- `/create` — Start creating a wedding website (onboarding)
- `/auth` — Login and signup
- `/w/:slug` — Published wedding websites (public guest-facing)

### Dashboard (Authenticated)
- `/dashboard` — Wedding site overview
- `/dashboard/editor` — Visual block editor
- `/dashboard/guests` — Guest list management
- `/dashboard/rsvps` — RSVP response tracking
- `/dashboard/messages` — Guest messages
- `/dashboard/photos` — Photo gallery management
- `/dashboard/media-messages` — Video/audio guest messages
- `/dashboard/budget` — Budget tracker
- `/dashboard/settings` — Site settings

### SEO Hub Pages (Programmatic Content)
- `/wedding-ideas` — Wedding ideas & inspiration hub
- `/wedding-ideas/:slug` — Individual wedding idea article
- `/compare` — Wedding service comparisons hub
- `/compare/:slug` — Individual comparison article
- `/features` — Wedding website features hub
- `/features/:slug` — Individual feature article
- `/locations` — Wedding destinations & venues hub
- `/locations/:slug` — Individual location article
- `/styles` — Wedding styles & themes hub
- `/styles/:slug` — Individual style article
- `/answers` — Wedding planning answers hub
- `/answers/:slug` — Individual answer article

### Legal
- `/privacy` — Privacy Policy
- `/terms` — Terms of Service
- `/cookies` — Cookie Policy

### Utility
- `/find-my-photos/:siteId` — AI face-recognition photo finder for guests
- `/reset-password` — Password reset

## Templates (20 Total)

### Style Templates
1. **Pastel Romantic** (`pastel-romantic`) — Soft colors and elegant typography for romantic weddings
2. **Modern Minimal** (`modern-minimal`) — Clean lines and bold simplicity for contemporary couples
3. **Rustic Bohemian** (`rustic-bohemian`) — Earthy tones and natural charm for outdoor weddings
4. **Classic Elegance** (`classic-elegance`) — Timeless sophistication for formal celebrations
5. **Midnight Glamour** (`midnight-glamour`) — Dark and dramatic elegance for evening events

### Venue Templates
6. **Garden Party** (`garden-party`) — Fresh florals and natural textures
7. **Tropical Paradise** (`tropical-paradise`) — Beach and destination wedding vibes
8. **Mediterranean** (`mediterranean`) — Azure blues and coastal elegance
9. **Vineyard Romance** (`vineyard-romance`) — Wine country charm and rustic luxury
10. **Mountain Retreat** (`mountain-retreat`) — Outdoor mountain beauty and adventure

### Cultural Templates
11. **Royal Indian** (`royal-indian`) — Opulent traditional patterns for Indian weddings
12. **Celtic Heritage** (`celtic-heritage`) — Ancient mystical beauty with Celtic knots
13. **African Elegance** (`african-elegance`) — Bold Kente patterns and earth tones
14. **Chinese Harmony** (`chinese-harmony`) — Traditional red and gold for Chinese weddings

### Seasonal Templates
15. **Winter Wonderland** (`winter-wonderland`) — Magical winter elegance with snowflakes
16. **Autumn Harvest** (`autumn-harvest`) — Warm fall colors and rustic details
17. **Cherry Blossom** (`cherry-blossom`) — Delicate spring beauty with sakura motifs

### Religious Templates
18. **Jewish Tradition** (`jewish-tradition`) — Elegant ceremony design with Star of David
19. **Christian Grace** (`christian-grace`) — Classic stained glass patterns and crosses
20. **Islamic Elegance** (`islamic-elegance`) — Beautiful geometric and arabesque patterns

## Website Building Blocks
Each wedding website can include these customizable sections:
- **Hero** — Main banner with couple photo and names
- **Profile** — Couple introduction and love story
- **Countdown** — Timer counting down to the wedding day
- **Story** — How-we-met narrative
- **Timeline** — Key relationship milestones
- **Events** — Ceremony, reception, and other event details
- **Venue** — Venue info with embedded maps and directions
- **RSVP** — Guest response form with meal preferences
- **Gallery** — Photo gallery with grid/masonry layout
- **Guest Photos** — Guest-uploaded photo wall
- **Guest Messages** — Guestbook with public messages
- **Guest Media** — Video and audio message recording
- **Wedding Party** — Bridesmaids, groomsmen, and attendant profiles
- **Family** — Family member introductions
- **Gift Registry** — Links to gift registries
- **Accommodation** — Hotel and lodging recommendations
- **Dress Code** — Attire guidelines with visual examples
- **FAQ** — Frequently asked questions
- **Traditions** — Cultural wedding traditions explained
- **Love Letter** — Personal letter from the couple
- **Memory Lane** — Photo timeline of the relationship
- **Trivia** — Interactive quiz about the couple
- **Advice Cards** — Guest advice and well-wishes
- **Photo Booth** — Fun photo frames for guests
- **Live Stream** — Virtual attendance link
- **Video** — Embedded video content
- **Thank You** — Post-wedding gratitude message
- **Footer** — Social links and credits

## Key Features
- **AI Content Generation** — GPT-powered writing for wedding descriptions, stories, and vows
- **AI Magic Setup** — Answer a few questions and AI generates a complete wedding website
- **20+ Templates** — Culturally diverse designs covering Indian, Chinese, Celtic, African, Jewish, Christian, Islamic traditions
- **RSVP Management** — Track responses, meal preferences, dietary restrictions, plus-ones
- **Guest List Import** — CSV/Excel import for bulk guest management
- **Photo Galleries** — Multiple gallery layouts with guest upload support
- **AI Face Recognition** — Find-my-photos feature using face detection
- **Photo Enhancement** — AI-powered photo editing
- **Guest Media** — Video and audio message recording from guests
- **QR Code Sharing** — Generate QR codes for easy site sharing
- **URL Shortening** — Custom short URLs for wedding sites
- **Multi-language** — Translation support with dual-language display
- **Budget Tracker** — Category-based budget management with charts
- **Countdown Timer** — Animated countdown to wedding day
- **Password Protection** — Private sites with password gate
- **Post-Wedding Mode** — Automatic transition to thank-you mode after the date
- **Mobile Responsive** — Optimized for all devices with touch-friendly interactions
- **PWA Support** — Installable as mobile app with offline capabilities

## Pricing Tiers
- **Free** — 1 template, basic features, WeddingBuilder branding
- **Premium** — All templates, unlimited photos, custom domain, no branding
- **Ultimate** — Everything in Premium plus priority support, AI features, analytics

## Technical Stack
- React 18 + TypeScript + Vite 5
- Tailwind CSS with shadcn/ui components
- Supabase for database, auth, storage, and edge functions
- Framer Motion for animations
- Progressive Web App (PWA) with service worker
- Dynamic sitemap and robots.txt
- Structured data (JSON-LD) for Organization, WebApplication, FAQ, Article, Event, Breadcrumb

## API Capabilities
- Template browsing and preview
- Wedding site creation and editing
- RSVP submission and tracking
- Guest message submission
- Photo upload and management
- AI content generation
- URL shortening
- Email notifications

## Content Categories (Programmatic SEO)
The site generates long-form content across six categories:
1. **Wedding Ideas** (`use_case`) — Planning tips, inspiration, DIY projects
2. **Comparisons** (`comparison`) — Side-by-side vendor/service reviews
3. **Features** (`feature`) — Deep dives into platform capabilities
4. **Locations** (`location`) — Destination and venue guides
5. **Styles** (`style`) — Theme, color palette, and décor inspiration
6. **AI Answers** (`ai_answer`) — Expert answers to wedding planning questions

## Contact
- Website: https://wedding-magic-fast.lovable.app
- Contact page: https://wedding-magic-fast.lovable.app/contact