HEAD

💖 Valentine's Special – A Romantic & Interactive Web Experience

🌟 About the Project

The Valentine’s Special is an interactive and fun web experience that allows users to plan their dream Valentine's date with personalized choices. Featuring beautiful animations, a love compatibility test, background music, and a Capture & Share feature, it provides a memorable way to celebrate love!

---

✨ Features

✅ Plan Your Valentine’s Date – Select food, dessert, activities, and a date.
✅ Love Compatibility Calculator – See how well you and your crush match.
✅ Floating Hearts Animation – Romantic floating hearts to enhance the experience.
✅ Background Music – Play a love song while using the website.
✅ Animated Blooming Flower – Beautiful flower animations using CSS & GSAP.
✅ Capture & Share – Take a screenshot of your date choices and email them.
✅ Confetti Celebration – Fun confetti effect when you submit your choices.
✅ Mobile-Friendly & Responsive – Works on Android, iPhones, and desktops.
✅ Start Over Button – Reset all choices and pick again if you're not satisfied.

---

🛠 Tech Stack

• Frontend: HTML, CSS, JavaScript
• Libraries & APIs:
  • GSAP – Smooth animations
  • html2canvas – Capture screenshots
  • Canvas Confetti – Confetti effect
• Hosting Options: GitHub Pages / Vercel

---

🚀 Live Demo

🔗 Check it out here

---

📥 Installation

To run the project locally, follow these steps:

# Clone the repository
git clone https://github.com/Ubongar/valentine-special.git

# Open index.html in a browser
cd valentine-special
open index.html

---

📌 Deployment

✅ Deploy on GitHub Pages

1. Push the project to GitHub
2. Go to Settings > Pages
3. Set Branch to main (or master) and click Save
4. Your site will be available at:

   https://Ubongar.github.io/valentine-special/
   

✅ Deploy on Vercel

1. Install Vercel CLI:

   npm install -g vercel

2. Deploy the project:

   vercel

3. Follow setup instructions and get a live URL like:

   https://valentine-special.vercel.app/
   

---

📸 Screenshots

🔹 Home Page: (Show the main landing page with date options)
🔹 Love Compatibility Game: (Screenshot of the love percentage result)
🔹 Final Date Selection: (Displays user’s planned date choices before sharing)

---

🔮 Future Enhancements (In the Works)

🚀 AI Love Letter Generator – Auto-generate a personalized love letter.
🎭 Animated Valentine Proposal – Romantic interactive proposal feature.
🎶 Multiple Love Songs – Let users choose different background music.
💌 Save & Share Feature – Users can download their date plan as an image.
🎮 Fun Valentine Quizzes – Add romantic quiz games for extra fun.

---

🤝 Contributing

Want to improve the project? Feel free to fork, star, and submit a pull request!

---

📧 Contact

💌 Email: mikeerap14@gmail.com
🌍 GitHub: Ubongar

---

💖 Enjoy planning the perfect Valentine's date! 💖

---