# SiteForge by Otaga Studio — Complete Technical & Functional Reference

## Executive Summary
SiteForge (hosted at https://studio.otaga.in/) is an open, modern web application engineered by Otaga Studio. It integrates two powerful capabilities into a single lightweight platform:
1. A visual, drag-and-drop responsive website builder with instant production-ready code generation (HTML/CSS & React).
2. An interactive, walkable 3D celebration museum and virtual guestbook space powered by WebGL 2 and Three.js.

## 1. Drag & Drop Website Builder

### Component Catalog
- **Navigation & Headers**: Clean responsive navbar with logo, menu links, action buttons, and mobile drawer.
- **Hero Sections**: Impactful headers with headline, subheading, primary CTA buttons, and background imagery.
- **Feature Grids**: Multi-column responsive feature cards with icons, titles, and descriptive copy.
- **Content Blocks**: Alternating media & text sections, split layouts, and image showcases.
- **Social Proof**: Testimonial carousels, avatar cards, client logos, and metric counters.
- **Pricing Tables**: Tiered subscription and product pricing cards with feature checklists and highlight badges.
- **FAQ Accordions**: Expandable semantic FAQ panels structured for accessibility and search engine parsing.
- **Forms**: Contact and inquiry forms with validated inputs.
- **Footers**: Multi-column navigational footers with copyright and social links.

### Export Engine
- **HTML + CSS Zip**: Produces a standalone, minified, production-grade static bundle with no external framework dependencies.
- **React Components**: Generates clean, idiomatic React (JSX) functional components ready to paste into Next.js, Vite, or Create React App.
- **Tailwind Compatibility**: Option to format layout classes matching Tailwind utility conventions.

## 2. Walkable 3D Celebration Museum & Interactive Virtual Spaces

### Core Mechanics
- **3D World**: Walkable virtual pavilion with skylights, ambient directional sunlight, fairy lights, and seasonal particle effects (petals, confetti, bubbles).
- **Controls**:
  - Desktop: WASD or Arrow keys to walk, click-and-drag to rotate camera, mouse wheel to zoom.
  - Mobile & Touch: Virtual on-screen joystick, single-finger drag to look around, pinch-to-zoom.
- **Cinematic Cinema Screen**:
  - Rotating photo wall featuring uploaded photos with smooth Ken Burns motion (pan and zoom).
  - Finale celebration slide with animated rising party balloons, tumbling confetti, and celebratory text.
  - Bench mode: Avatars sit together and watch the screen with theater framing and hidden UI clutter.
- **Themes Supported**:
  - **Wedding**: Burgundy and antique gold aesthetic, flower arch, ring centerpiece, custom couple avatars, wedding countdown.
  - **Birthday**: Vibrant celebration aesthetic, birthday star avatar, cake with candle blowing interaction, age milestone banners.
  - **Baby Shower**: Pastel sky blue and soft gold aesthetic, mobile wind toy interaction, expectant parents avatars.
- **Art Style Options**:
  - Original realistic WebGL standard shading.
  - Hand-painted NPR (Non-Photorealistic Rendering) shader filter replicating watercolor and ink illustrations.

## 3. Real-Time Cloud Guestbook & Wishes Sync

### Architecture
- **Zero-Server Invitation Links**: Museum parameters (names, dates, photos, venue, and cloud board IDs) are compressed via native `CompressionStream('gzip')` and encoded as URL hash anchors (`#museum=gz_...`).
- **Real-Time Board Sync**:
  - Any guest opening the invitation link connects to the celebration's live wish board.
  - Submitting a wish updates the cloud board and reflects instantly on the 3D wooden easel for all connected visitors.
  - Periodic background polling ensures incoming wishes from other guests appear live without page refreshes.
- **Guestbook Export**:
  - The celebration host or guests can download the complete list of wishes at any time.
  - Formats: Formatted keepsake `.txt` guestbook document and structured `.csv` spreadsheet.

## 4. Metadata & Discovery
- **Canonical URL**: https://studio.otaga.in/
- **Sitemap**: https://studio.otaga.in/sitemap.xml
- **LLM Manifest**: https://studio.otaga.in/llms.txt
- **License / Cost**: Free to use, no subscription required.
- **Developer & Studio**: Otaga Studio (https://otaga.in/)