💸ChalLedger - Challenge + Ledger

ChalLedger is a personal challenge tracking and budgeting web application.
Track your goals, monitor spending, and earn badges as you achieve challenges! 🎯💰🏅

---

🌟 Key Features

Feature	Description
🔐 Sign Up / Login	User authentication and session management
🧾 Create Challenge	Set goal spending amount and challenge duration
💳 Expense Tracking	Record and update actual spending
🏅 Badge System	Automatically grants badges when conditions are met
📊 Data Visualization	Monthly spending chart and challenge progress display

---

🏅 Badge Types

ChalLedger rewards users with unique badges based on challenge completion and spending patterns.

✅ 1. Challenge-related Badges

Badge Name	Icon	Criteria
First Challenge	🎉	Granted when user registers at least 1 challenge
3-Time Streak	🏅	Granted when user registers 3 or more challenges
Challenge Achiever	🎯	Granted when user successfully completes at least 1 challenge
Perfect Saver	🧊	Granted when actual_spending is 0 in at least one successful challenge

---

✅ 2. Spending Pattern Badges

Badge Name	Icon	Criteria
Food Budget Destroyer	💥🍔	Granted when last 5 expenses are all in the 'Food' category
Savings Superstar	⭐💵	Granted when last 3 expenses are each less than 5,000 KRW

---

✅ 3. Category-specific Badges

Category	Badge Name	Icon	Criteria
Transport	Transport Tracker	🚗	3+ expenses in category
Shopping	Shopping Spree	🛍️	2+ expenses
Entertainment	Entertainment Lover	🎬🎮	3+ expenses
Health	Health First	💪🥗	2+ expenses
Travel	Travel Budgeter	✈️🌍	1+ expense
Education	Lifelong Learner	📚	1+ expense
Bills	Bill Payer	🧾	2+ expenses
Pets	Pet Lover	🐾	2+ expenses
Gifts	Gift Giver	🎁	1+ expense
Others	Explorer	🧭	4+ expenses
Cafe	Cafe Enthusiast	☕	3+ expenses
Daily	Everyday Essentials	🛒	5+ expenses

---

🛠 Tech Stack

• Frontend: React.js, React Router, CSS (custom responsive design)
• Backend: Node.js, Express.js
• Database: PostgreSQL
• Testing: React Testing Library
• Performance: web-vitals (optional Core Web Vitals reporting)

---

📸 Demo Screenshots

Below are actual demo screenshots and GIFs of ChalLedger in action.

🔐 Sign Up & Login

📝 Full Challenge & Expense Flow

This GIF demonstrates the full flow from creating a challenge to adding expenses and viewing the expense history.

📝 Badges

📝 Weekly Spending Overview & Weekly Category Breakdown

👨‍👩‍👧‍👦 Team Introduction

Name	Role	Main Contributions
Doyi Kim	🧠 Project Planning & Design	Project planning, UI/UX design, badge system logic & display, chart visualization, footer layout
Haneol Lee	👨‍💻 Backend Lead	DB modeling, API development, user authentication, badge logic implementation
Sodam Lee	👩‍🎨 Frontend Lead	Challenge creation & logging UI, calendar-based expense tracking, responsive layout, footer styling

---

🧪 How to Run the Project

🚀 Live Demo

https://challedger.onrender.com