❤️ HeartScript - Open Source Quest Valentine Special

Love logic? Love design? Code it out.

HeartScript is a Valentine-themed open source project built using Next.js that combines creativity and technical innovation into a single platform. This project aims to encourage open source participation by blending UI design with algorithmic thinking, providing a beginner-friendly yet competitive environment for developers.

---

🚀 Event Details: Valentine Special

This project is launched as a 24-hour Valentine Special event under the Open Source Quest.

• Duration: 24 Hours.

• Scoring: 2X Contribution Scoring on this repository.

• Rewards: The top contributor will be rewarded with an exclusive title : Valentine Grand Architect on the website.

---

✨ Project Features

HeartScript is divided into two main components, allowing contributors to showcase both creativity and coding skills:

1. 💌 Valentine Card Generator

A customizable feature where users can create beautifully themed digital cards.

• Customization: Users can enter a name and write a personal message.

• Design: Select from multiple design themes.

• Interaction: Preview the card in real-time.

• Export: Download the final creation as a high-quality PDF.

2. 🧠 The Love Algorithm

A technical section where contributors can implement fun and logical romantic programs.

• Examples: Compatibility checkers, love score calculators, date optimizers, and other romantic-themed algorithms.

• Requirements: Each algorithm must be accompanied by explanations and a time complexity analysis.

3. 📥 Download Your Card

New! Download your created cards as high-quality images:

• Beautiful vintage "love letter seal" interface
• PNG and JPEG format options
• Professional quality output
• Mobile-friendly design

---

🛠️ Tech Stack

• Framework: Next.js.

• Focus: UI Design & Algorithmic Logic.

---

💻 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Node.js (Latest LTS version recommended)
• npm or yarn

Installation

1. Clone the repository

git clone https://github.com/R3ACTR/HeartScript.git
cd HeartScript

2. Install dependencies

npm install
# or
yarn install

3. Run the development server

npm run dev
# or
yarn dev

4. Open http://localhost:3000 with your browser to see the result.

---

🤝 How to Contribute

We welcome contributions to both the Card Generator (UI/Frontend) and the Love Algorithms (Logic/Backend) sections.

Contributing to the Card Generator

1. Navigate to the components/card-generator directory (example structure).
2. Add new themes, improve the real-time preview, or enhance the PDF download functionality.

Contributing to Love Algorithms

1. Navigate to the algorithms directory.
2. Create a new file for your algorithm (e.g., compatibilityChecker.js).
3. Important: You must include comments explaining your code and a breakdown of the time complexity.

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Happy Coding and Happy Valentine's Day! ❤️