🌹 Virtual Rose Garden

🌹 Real-time 3D rose garden where everyone can plant a rose with a love message. All visitors see all roses bloom instantly via WebSocket. Perfect for Valentine's Day 2026!

✨ Features

3D Garden Experience

• Three.js Rendering — Beautiful 3D rose garden with realistic lighting
• Procedural Roses — Each rose is uniquely generated with petals, stem, and leaves
• Bloom Animation — Roses grow and bloom with elastic animation
• Fireflies — Ambient particles floating in the garden
• Grass Particles — Ground covered with grass-like particles
• OrbitControls — Rotate and zoom the camera

Real-time Collaboration

• WebSocket Sync — New roses appear instantly for all visitors
• Persistent Storage — SQLite database saves all roses
• Live Counter — See total roses in the garden
• Connection Status — Visual indicator for WebSocket connection

Plant Your Rose

• Click to Plant — Click anywhere on the ground to plant
• Custom Message — Write a love message (up to 200 characters)
• Author Name — Optional name or anonymous
• Color Selection — Choose from 8 rose colors
• Hover Tooltips — See messages when hovering over roses

🚀 Quick Start

Clone and run:

git clone https://github.com/smart-developer1791/go-virtual-rose-garden
cd go-virtual-rose-garden

Initialize and start:

go mod tidy
go run .

Open http://localhost:3000 🌹

🛠 Tech Stack

Layer	Technology
Backend	Go 1.21+, Fiber v2
Real-time	WebSocket (Fiber)
Database	SQLite + GORM (Pure Go)
3D Engine	Three.js r160
Frontend	Alpine.js 3.x, Tailwind CSS
Fonts	Playfair Display, Quicksand

📁 Project Structure

go-virtual-rose-garden/
├── main.go              # Server, WebSocket, API
├── go.mod               # Dependencies
├── render.yaml          # Deploy config
├── .gitignore
├── README.md
└── templates/
    └── index.html       # 3D garden app

🌐 API Endpoints

Method	Path	Description
GET	/	Main garden page
GET	/api/roses	Get all roses
POST	/api/roses	Plant a new rose
GET	/api/stats	Garden statistics
WS	/rose-ws	Primary WebSocket endpoint used by the web app
WS	/ws	Legacy compatibility endpoint (same behavior)

POST /api/roses Body

{
  "message": "I love you",
  "author": "Valentine",
  "x": 2.5,
  "z": -1.3,
  "color": "#e11d48"
}

WebSocket Messages

Type	Direction	Data
all_roses	Server → Client	Array of all roses on connect
new_rose	Server → Client	New rose object when planted
ping	Client → Server	Keep-alive ping
pong	Server → Client	Keep-alive response

🎨 Rose Colors

Color	Hex
Classic Red	#e11d48
Bright Rose	#f43f5e
Deep Red	#be123c
Light Pink	#fb7185
Burgundy	#9f1239
Blush	#fda4af
Hot Pink	#f472b6
Magenta	#ec4899

🎮 Controls

Action	Result
Click on ground	Open plant modal
Drag	Rotate camera
Scroll	Zoom in/out
Hover on rose	Show message tooltip

💾 Database Schema

CREATE TABLE roses (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    message TEXT NOT NULL,
    author TEXT DEFAULT 'Anonymous',
    x REAL NOT NULL,
    z REAL NOT NULL,
    color TEXT DEFAULT '#e11d48',
    scale REAL DEFAULT 1.0,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

🌙 Visual Effects

• Moonlight — Directional light with soft shadows
• Pink Glow — Point light adding romantic atmosphere
• Warm Light — Secondary point light for depth
• Fog — Exponential fog for depth effect
• Fireflies — Animated glowing particles
• Rose Sway — Gentle swaying animation

💕 Valentine's Day 2026

Plant a rose for someone special! Every rose in the garden carries a message of love, visible to everyone who visits.

"A single rose can be my garden... a single friend, my world." — Leo Buscaglia

⚡ Performance

• Three.js with ES modules (no build)
• Efficient WebSocket broadcasting
• SQLite for lightweight persistence
• Optimized particle systems
• Shadow map caching

---

Deploy in 10 seconds