💕 Valentine Countdown ~ Ai no Kauntodaun

🌸 Japanese-themed countdown to Valentine's Day with 3D sakura petals, floating lanterns, daily love quotes, and beautiful hiragana/katakana decorations. Auto-resets each year on February 15th!

✨ Features

Japanese Aesthetic

• Sakura Petals — 150 falling cherry blossom petals in 3D
• Paper Lanterns — Floating chochin lanterns with warm glow
• Heart Particles — Ambient floating hearts
• Hiragana/Katakana — Decorative Japanese characters
• Japanese Fonts — Noto Sans JP, Shippori Mincho
• Color Palette — Sakura pink, ume plum, kincha gold

Countdown Features

• Live Countdown — Days, hours, minutes, seconds to Feb 14
• Auto-Reset — Starts counting to next year on Feb 15
• Valentine's Day Mode — Special celebration screen on Feb 14
• Target Year Display — Shows which Valentine's Day

Daily Content

• Love Quotes — 15 romantic quotes with authors
• Japanese Phrases — Love expressions with romanji
• Valentine Facts — Interesting trivia about the holiday
• Gift Ideas — Creative date and gift suggestions
• Deterministic Selection — Same content all day, changes at midnight

🚀 Quick Start

Clone and run:

git clone https://github.com/smart-developer1791/go-valentine-countdown
cd go-valentine-countdown

Initialize and start:

go mod tidy
go run .

Open http://localhost:3000 🌸

🗓️ How Date Logic Works

Current Date          Target Valentine's Day
─────────────────────────────────────────────
Jan 1 - Feb 14  →    Feb 14 of current year
Feb 15 - Dec 31 →    Feb 14 of next year

Example:

• If today is January 30, 2026 → counting to Feb 14, 2026
• If today is February 20, 2026 → counting to Feb 14, 2027

🛠 Tech Stack

Layer	Technology
Backend	Go 1.21+, Fiber v2
3D Engine	Three.js r160
Frontend	Alpine.js 3.x, Tailwind CSS
Fonts	Noto Sans JP, Shippori Mincho

📁 Project Structure

go-valentine-countdown/
├── main.go              # Server, countdown logic, daily content
├── go.mod               # Dependencies
├── render.yaml          # Deploy config
├── .gitignore
├── README.md
└── templates/
    └── index.html       # Single page with 3D scene

🌐 API Endpoints

Method	Path	Description
GET	/	Main countdown page
GET	/api/countdown	Get countdown data
GET	/api/daily	Get daily content

GET /api/countdown Response

{
  "target_year": 2026,
  "days_left": 42,
  "hours_left": 15,
  "minutes_left": 30,
  "seconds_left": 45,
  "total_seconds": 3681045,
  "is_valentine_day": false
}

GET /api/daily Response

{
  "quote": {
    "text": "Love is composed of a single soul...",
    "author": "Aristotle"
  },
  "fact": "In Japan, women give chocolates to men...",
  "idea": "Write a heartfelt love letter by hand...",
  "japanese": "愛してる",
  "romanji": "Aishiteru - I love you",
  "day_of_year": 45
}

🎨 Color Palette

Color	Hex	Japanese Name
Sakura 400	#f48ca2	桜 (sakura)
Sakura 300	#f8b4c2	薄桜 (usuzakura)
Kincha	#c7802d	金茶 (kincha)
Fuji	#89729e	藤 (fuji)
Ume	#e03c8a	梅 (ume)

🌸 3D Visual Effects

• Sakura Petals — 150 falling petals with physics
• Paper Lanterns — 8 floating chochin with glow
• Heart Particles — 30 floating hearts
• Stars — 100 twinkling background stars
• Sway Animation — Natural wind-like movement

🎌 Japanese Elements

Decorative Text

• Vertical kanji: 愛永遠恋心 (love, eternity, romance, heart)
• Hiragana: あいしてる (aishiteru)
• Katakana: アイシテル (aishiteru)

Daily Japanese Phrases

• 愛してる (Aishiteru) — I love you
• 大好き (Daisuki) — I really like you
• 一目惚れ (Hitomebore) — Love at first sight
• 運命の人 (Unmei no hito) — Destined person
• And more...

💕 Valentine's Day 2026

Count down the days until you can express your love! This app brings the beauty of Japanese aesthetics to the anticipation of Valentine's Day.

"愛は永遠に" — Love is forever

---

Deploy in 10 seconds