🌿 THE ETERNAL GARDEN

An immersive, interactive digital sanctuary bridging 9,999 miles.
Built with fluid animations and sensory storytelling to bring two souls closer through a digital glade.

---

🍃 INTRODUCTION

The Eternal Garden is an interactive "living letter" designed to transform the pain of distance into a journey of growth. It gamifies the concept of "Harmony" across continents. Users must tend to the garden—clearing the mist, unblocking the river, and gathering fireflies—to cultivate enough energy to unlock a final, hidden message of love.

---

🌸 PERSONALIZE THE BLOOM

To target a specific recipient and see their name flourish within the garden, you must inject a Name Parameter into the URL string.

ACTION	INSTRUCTION
Step 1	Copy your deployment URL
Step 2	Append ?n=Name to the end of the address

mayborg121.github.io/garden?n=RecipientName

Example : mayborg121.github.io/garden?n=Soulmate

_{The garden will dynamically rewrite its whispers and the final letter to address the specified user.}

---

🕹️ INTERACTIVE FEATURES

Feature	Mechanics
🌫️ Fog Clearance	Scratch-to-reveal canvas interaction to see through the "distance."
💎 River Flow	Physics-based interaction where clearing stones increases harmony.
🍃 Whisper Canopy	Interactive grid where users discover hidden "Golden Whispers."
🐦 Spirit Guide	Draggable bird flight mechanics to reach the garden's bloom.
✨ Firefly Grove	Kinetic "catch" game to light the path to the final sequence.

---

🛠️ TECH STACK

The project is built with a focus on buttery-smooth 60FPS interactions and high visual fidelity:

• Frontend: HTML5 (Canvas), CSS3 (Modern Glassmorphism)
• Styling: Tailwind CSS for the responsive, nature-inspired design system.
• Animations: GSAP (GreenSock Animation Platform)
  • ScrollTrigger: For distance tracking and element reveal on scroll.
  • Draggable: For the bird flight mechanics.
  • Timeline: For the cinematic "Heart Opening" sequence.
• Visual Effects: Procedural mist layers, falling leaf particle systems, and canvas global-composite-operation for scratch-away effects.

---

🔧 INSTALLATION & USAGE

1. Clone the repository:

   git clone [https://github.com/Mayborg121/The-Eternal-Garden.git](https://github.com/Mayborg121/The-Eternal-Garden.git)

Plant the Seed: Simply open index.html in any modern web browser. No build steps required.

📜 LICENSE

This project is licensed under the GPL-3.0 License.

👤 AUTHOR

Mayborg | GitHub: @Mayborg121

"Distance is just a number. Our bond is the destination."