# romantic-animations 💖

A beautiful JavaScript library for romantic particle effects such as floating hearts, heart trails, love bursts, and more. Perfect for Valentine's Day, wedding websites, or any love-themed project.

## ✨ Features
- ❤️ Floating hearts animation
- 💘 Easy to integrate
- 📦 Zero dependencies
- ⚙️ Fully customizable (soon)

## 📦 Installation
```bash
npm install romantic-animations
```

## 🚀 Usage
```html
<div id="animation-container"></div>
<script type="module">
  import { startFloatingHearts } from 'romantic-animations';
  startFloatingHearts("animation-container");
</script>
```

## 📁 File Structure
- `src/` – core engine and animation modules
- `demo/` – live preview setup using Vite
- `package.json` – npm config

## 🔮 Upcoming
- 💫 Cursor heart trails
- 🎉 Love confetti bursts
- 🌈 Color customization
- 🎨 Preset themes

## 🧑‍💻 Author
Made with ❤️ by **Sarthak Singh**

## 📄 License
MIT