ValentineWish
ValentineWish is a web application designed to help users create and share personalized Valentine's Day wishes. The application provides a collection of beautiful Valentine-themed templates and allows users to customize their messages. It is built using JavaScript, HTML, and CSS, ensuring a responsive and user-friendly experience.
Install / Use
/learn @SandeepVashishtha/ValentineWishREADME
Valentine Wish
An animated, customizable Valentine's Day greeting webpage to send special wishes to your loved ones! This project features smooth animations, beautiful visuals, and is fully customizable to make your Valentine's Day message unique and memorable.
Features
- Beautiful Animations: Smooth GSAP-powered animations that create a delightful user experience
- Fully Customizable: Easy customization through a simple JSON configuration file
- Responsive Design: Works seamlessly across different devices and screen sizes
- Interactive Elements: Engaging animations with floating balloons, hearts, and more
- Personal Touch: Add custom names, messages, and images
- Replay Option: Allow recipients to watch the animation again
Preview
The animation sequence includes:
- Personalized greeting with the recipient's name
- Valentine's Day announcement
- A thoughtful message progression
- Special wishes with custom image
- Floating balloons and hearts
- Interactive replay option
Getting Started
Prerequisites
No special software or dependencies required! This is a simple static website that runs in any modern web browser.
Installation
- Clone the repository:
git clone https://github.com/SandeepVashishtha/ValentineWish.git
- Navigate to the project directory:
cd ValentineWish
- Open
index.htmlin your web browser, or use a local server:
# Using Python 3
python -m http.server 8000
# Using Python 2
python -m SimpleHTTPServer 8000
# Using Node.js http-server (install with: npm install -g http-server)
http-server
- Visit
http://localhost:8000in your browser
Customization
Customize the Valentine's wish by editing the customize.json file:
{
"name": "Your Loved One's Name",
"greetingText": "Your greeting message here!",
"wishText": "Your special Valentine's wish here!",
"imagePath": "img/your-image.jpg"
}
Configuration Options
- name: The recipient's name that appears in the greeting
- greetingText: A personalized greeting message
- wishText: Your main Valentine's Day wish/message
- imagePath: Path to a custom image (add your image to the
img/folder)
Adding Your Own Image
- Add your image to the
img/folder - Update the
imagePathincustomize.jsonto point to your image - Supported formats: JPG, PNG, SVG
Project Structure
ValentineWish/
├── index.html # Main HTML file
├── customize.json # Customization configuration
├── script/
│ └── main.js # Animation logic and data handling
├── style/
│ └── style.css # Styling and layout
├── img/ # Images and SVG assets
│ ├── balloon.svg
│ ├── heart.svg
│ ├── happy.svg
│ ├── music-note.svg
│ ├── smiling.svg
│ ├── valentine.jpg
│ └── vector.jpg
└── README.md # This file
Technologies Used
- HTML5: Structure and content
- CSS3: Styling and responsive design
- JavaScript (ES6): Logic and interactivity
- GSAP (GreenSock Animation Platform): Professional-grade animations
- Babel Standalone: ES6+ JavaScript support
Usage Tips
- Personalize it: Make sure to update all fields in
customize.jsonfor a truly personal touch - Test locally: Preview the animation before sharing to ensure everything looks perfect
- Share the link: Host it on GitHub Pages, Netlify, or Vercel for easy sharing
- Mobile-friendly: The animation works great on mobile devices too!
Deployment
GitHub Pages
- Go to your repository settings
- Navigate to "Pages" section
- Select the branch (usually
mainormaster) - Click "Save"
- Your site will be available at
https://yourusername.github.io/ValentineWish/
Netlify or Vercel
Simply drag and drop the project folder to Netlify or Vercel for instant deployment.
Contributing
Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Acknowledgments
- GSAP for the amazing animation library
- All the open-source contributors who make projects like this possible
- Special thanks to everyone celebrating love on Valentine's Day!
Show Your Support
If you found this project helpful or used it to make someone's Valentine's Day special, please give it a star!
Made with love for Valentine's Day
