Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aditypraa/gift-card-app
Gift Card App with ReactJs
https://github.com/aditypraa/gift-card-app
Last synced: 15 days ago
JSON representation
Gift Card App with ReactJs
- Host: GitHub
- URL: https://github.com/aditypraa/gift-card-app
- Owner: Aditypraa
- Created: 2024-12-05T11:49:24.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2024-12-05T22:01:16.000Z (23 days ago)
- Last Synced: 2024-12-05T23:18:01.696Z (23 days ago)
- Language: JavaScript
- Homepage: https://gift-card-app-one.vercel.app
- Size: 115 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎁 Gift Card App
> **Seamlessly Manage Your Digital Gift Cards with Ease** 💳✨
## 📋 Table of Contents
- [🌟 Introduction](#-introduction)
- [✨ Features](#-features)
- [🧩 Dependencies](#-dependencies)
- [🚀 Installation](#-installation)
- [🔍 Usage](#-usage)
- [🤝 Contributing](#-contributing)
- [🧪 Testing](#-testing)
- [🌐 Deployment](#-deployment)
- [📄 License](#-license)
- [📞 Contact](#-contact)
## 🌟 Introduction
The **Gift Card App** is a modern, user-friendly web application built with **ReactJS**. It provides a seamless platform for managing digital gift cards from various stores and services.
## Assets / Template Gift Card
Click : [Template Link](https://1drv.ms/f/c/38f699ce66e02bba/Et7F_wmsruxAjhNqhPKjUYgBAhUxahLoA5R0-Zo8yQiYrQ?e=qHgS7P)
## ✨ Features
- 💼 **Gift Card Management**: Effortlessly add, view, and organize multiple gift cards
- 🔓 **Redeem Functionality**: Quick and simple gift card redemption
- 🖼️ **Visual Representation**: Customized card displays with rich imagery
- 📱 **Responsive Design**: Optimized for mobile and desktop
## 🧩 Dependencies
### 📦 Frontend Dependencies
| Package | Version | Purpose |
| -------------- | -------- | ------------------ |
| `html2canvas` | ^1.4.1 | Screenshot capture |
| `lucide-react` | ^0.468.0 | UI Icons |
| `react` | ^18.3.1 | UI Library |
| `react-dom` | ^18.3.1 | DOM Bindings |
### 🛠️ Development Dependencies
| Package | Version | Purpose |
| ------------------------ | ------- | ------------------------- |
| `@babel/preset-env` | ^7.26.0 | Environment Compatibility |
| `@testing-library/react` | ^16.0.1 | React Testing Utilities |
| `tailwindcss` | ^3.4.16 | Styling Framework |
| `vite` | ^6.0.1 | Build Tool |
## 🚀 Installation
### 📋 Prerequisites
- [Node.js](https://nodejs.org/) (v14+)
- [npm](https://www.npmjs.com/) (v6+)
### 🔧 Setup Steps
```bash
# Clone the repository
git clone https://github.com/Aditypraa/gift-card-app.git
# open folder
cd gift-card-app
# Install dependencies
npm install
# Start development server
npm run dev
```
## 🔍 Usage
### 📥 Adding Gift Cards
1. Click "Add Gift Card" on the home page
2. Fill in card details
3. Save your new gift card
### 👀 Viewing Gift Card Details
1. Browse gift cards on the home page
2. Click a card to view its details
3. Explore card information
### 💸 Redeeming Gift Cards
1. Navigate to card details
2. Click "Redeem"
3. Follow redemption instructions
## 🤝 Contributing
### 🍴 How to Contribute
1. Fork the repository
2. Create a new branch
3. Make your changes
4. Write tests
5. Submit a pull request
## 🧪 Testing
```bash
# Run unit tests
npm test
# Run integration tests
npm run test:integration
```
## 🌐 Deployment
```bash
# Build production version
npm run build
```
**Hosting Platforms**:
- Vercel
## 📄 License
**MIT License** - See [LICENSE](LICENSE) for details.
## 📞 Contact
**Aditya Pratama**
- 📧 [Email]([email protected])
- 🐛 [Report Issues](https://github.com/Aditypraa/gift-card-app/issues)
---
**Happy Gift Card Managing! 🎉**