# Love Letter Studio — 15-Day Private Love Keepsakes

> Love Letter Studio is an ultra-bespoke, ephemeral digital romantic keepsake platform engineered with luxury aesthetics, procedural Web Audio acoustics, 60 FPS interactive physics, and an AI-driven LLM Studio. Each love capsule is private, unlisted, and active for exactly 15 calendar days before graceful automated archival.

## Core Capabilities & Architecture

- **Domain**: `https://loveletter.friskysoftsell.in`
- **Architectural Philosophy**: Intimacy through ephemerality. Unlike permanent social posts or ephemeral messaging apps, keepsakes exist in an unlisted 15-day theater window, preserving the rarity and vulnerability of heartfelt emotion.
- **Client Technology**: Pure Vanilla HTML5, CSS3 Custom Properties, and ESNext JavaScript. Zero runtime npm, framework, or node dependencies.
- **Backend Technology**: Python standard library (`sqlite3`, `http.server`, `threading`, `urllib`) with optional MySQL/phpMyAdmin compatibility for Hostinger deployment.
- **AI & LLM Integration**: Multi-provider LLM Studio supporting Google Gemini, OpenAI GPT-4o, Anthropic Claude 3.5 Sonnet, and local/custom OpenAI-compatible endpoints (Ollama, Groq, OpenRouter), coupled with an offline procedural romantic fallback engine.

## The 7-Act Recipient Journey

1. **Act 1: The Sealed Envelope**: Interactive 3D wax seal with authentic audio crackle and opening unfold sequence.
2. **Act 2: The Fountain Pen Letter**: Ambient soundtrack, authentic handwriting typography, and poetic phrasing.
3. **Act 3: Three Little Truths**: Staggered revelation of three intimate reasons why the creator chooses the recipient.
4. **Act 4: Memory Photo Vault**: Interactive polaroid cards with perspective tilt and client-side image compression.
5. **Act 5: Cake & Candle Ceremony**: Multi-tier celebration cake with interactive flame blowout physics and audio puff effects.
6. **Act 6: Sassy Runaway Question**: Interactive proposal / affirmation prompt featuring a playful "Let Me Think" button with evasive boundary physics.
7. **Act 7: The Grand Finale**: Joyful confetti cannon, audio crescendo chime, and completion receipt.

## Visual Design & Aesthetic Worlds

Each keepsake can inhabit one of eleven bespoke aesthetic themes:
- **Rose**: Soft blush, dusty crimson, warm ivory, and floating petals.
- **Scrapbook**: Kraft paper textures, nostalgic tape borders, and warm sepia tones.
- **NeoClassical**: Editorial dark luxury, deep obsidian `#070709`, and gilded gold `#d4af37`.
- **BentoGrid**: Modern sapphire `#0f172a`, crisp glassmorphic panels, and neon cyan accents.
- **PixelArt**: Nostalgic 8-bit retro gaming typography, neon purple, and CRT scanlines.
- **Gothic**: Velveteen midnight, deep wine `#9f1239`, and vintage Victorian flourishes.
- **Y2K Aesthetic**: Pastel pinks, iridescent blues, sticker typography, and nostalgic millennium vibes.
- **Midnight**: Astral indigo, velvet violet, and starlight shimmer.
- **Cinema**: Letterbox widescreen format, warm amber spotlights, and cinematic grain.
- **Starlight**: Cosmic constellations, glowing stellar motes, and twilight hues.
- **Garden**: Fresh botanical greens, dewdrop highlights, and organic floral motifs.

## Essential Documentation & Endpoints

- [Studio Creator Desk](https://loveletter.friskysoftsell.in/): Interactive keepsake creator form, live preview card, and AI assistant tools.
- [Live Synchronized Couple Photobooth](https://loveletter.friskysoftsell.in/photobooth.html): Ultra-low latency WebRTC peer-to-peer streaming photobooth allowing long-distance couples to capture synchronized vintage photo strips side-by-side in real-time.
- [Knowledge Base & Curated FAQs](https://loveletter.friskysoftsell.in/faq.html): Comprehensive guide covering duo photobooth rooms, wax seal unboxing, music curation, and 15-day privacy retention.
- [Terms & 15-Day Privacy Policy](https://loveletter.friskysoftsell.in/terms.html): Detailed privacy specifications, rate-limiting rules, and automated retention timelines.
- [Full LLM Technical Specification](https://loveletter.friskysoftsell.in/llms-full.txt): Comprehensive deep-context documentation for developers, AI agents, and RAG pipelines.
- [XML Sitemap](https://loveletter.friskysoftsell.in/sitemap.xml): Machine-readable index of public studio URLs.
- [Robots Configuration](https://loveletter.friskysoftsell.in/robots.txt): Crawler governance, AEO/GEO directives, and privacy guards.

## API Endpoints (Public & Safe for Agent Interaction)

- `GET /api/seo-config`: Retrieves public-safe metadata, brand parameters, and social card configurations.
- `GET /api/faqs`: Retrieves published FAQ questions and answers categorized by topic for search engines and help centers.
- `GET /api/footer`: Retrieves public-safe Atelier footer configuration, trust chips, and verified suite navigation links.
- `POST /api/create-surprise`: Creates a new 15-day unlisted keepsake capsule.
- `GET /api/get-surprise?id={id}`: Retrieves public recipient keepsake metadata (valid for active, unexpired capsules only).
- `POST /api/photobooth/create`: Generates an encrypted temporary duo photobooth room code for long-distance partners.
- `POST /api/photobooth/join`: Connects a partner to a duo photobooth room via WebRTC handshake.
- `POST /api/photobooth/save-strip`: Compiles and archives high-resolution retro film photo strips.
- `POST /api/ai/suggest-letter`: Generates or refines an authentic, emotionally resonant love letter.
- `POST /api/ai/suggest-reasons`: Suggests three bespoke, heartfelt reasons based on recipient details and occasion.