# QuestChain 🎯

QuestChain ([LINK](https://questchain.pages.dev)) is a smart system that helps you stay accountable, track progress, and build strong habits with a structured, **weightage-based** approach and **activity heatmap** to visualise consistency.

## 🌟 Features

- **Daily Quests**: Create and track daily tasks with customizable goals and weightage, set quantitative targets for tasks, and schedule quests for future days
- **Activity Heatmap**: Visualize your consistency with a GitHub-style activity heatmap
- **Regularity Tracking**: Monitor your completion rate with detailed statistics and pie charts
- **Today's Progress**: Monitor your progress for today's tasks
- **Task Motivation**: : Get real-time progress insights, a dynamic activity heatmap, and comprehensive regularity scores to inspire consistent task completion and drive daily productivity.
- **User Authentication**: Secure signup/login system with JWT authentication
- **Responsive Design**: Works seamlessly on both desktop and mobile devices
- **Quest Types**
- **Goal-Based Quests** 🎯
- Set numerical goals (e.g., "Read 20 pages")
- Track progress with interactive slider
- Visual progress bars
- Real-time progress updates
- **Checklist Quests** ✔️
- Simple yes/no completion tasks
- Quick toggle checkboxes
- Color-coded status (Green/Red)
- One-click completion

- **Enhanced Progress Tracking**
- Group tasks by quest type
- Combined progress view
- Color-coded status indicators
- Visual completion markers

## 🛠️ Tech Stack

### Frontend
- React.js
- Chart.js for data visualization
- RSuite Calendar Component
- Axios for API calls
- React Icons
- CSS3 with modern flexbox layouts

### Backend
- Node.js
- Express.js
- MongoDB with Mongoose
- JWT for authentication
- bcryptjs for password hashing
- Express Validator

## 🚀 Getting Started

<!-- ### Prerequisites
- Node.js (v14 or higher)
- MongoDB
- npm or yarn

### Installation

1. Clone the repository

git clone https://github.com/yourusername/questchain.git
cd questchain

2. Install backend dependencies

cd backend
npm install

3. Install frontend dependencies

cd ../frontend
npm install

4. Create a .env file in the backend directory

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret

5. Start the servers

# In backend directory
npm run dev

# In frontend directory
npm start

### Android Installation

While there is no actual app, but we can you a simple feature which chrome provide to install website as app on android and iphone!🎉
[Installation LINK (Click here)](https://drive.google.com/file/d/1jTbm5LL1C-jsqngabNvlwOJu_LByj9S-/view?usp=sharing)

The app will be installed within a minute or two than you can use it seamlessly

### 📱 Demo Video
Check out QuestChain in action on Android:
[DEMO LINK (Click here)](https://drive.google.com/file/d/1hEyKpjg-2hHVLxAmbmvrNQyY5aTXc4UE/view?usp=sharing)

## 💡 How It Works

1. **Create Quests**
- Set daily tasks with specific goals
- Assign weightage points for incomplete tasks
- Choose duration for recurring tasks
- Choose between Goal-Based or Checklist quests
- Set appropriate completion criteria
- Group similar tasks together

2. **Track Progress**
- Update task progress throughout the day
- View completion status in real-time
- Get instant feedback on the progress

3. **Monitor Consistency**
- Check your activity heatmap
- View regularity percentage
- Track completed vs incomplete days

## 🔒 Security Features

- Password hashing with bcrypt
- JWT-based authentication
- Protected API routes
- Input validation and sanitization

## 🎨 UI Features

- Clean, modern interface
- Responsive design
- Interactive calendars
- Progress visualization
- Activity heatmaps
- Statistical charts
- Quest type grouping
- Color-coded status indicators

## 📱 Mobile Responsiveness

- Hamburger menu for mobile navigation
- Adaptive layouts
- Touch-friendly interface
- Optimized performance

<!-- ## 🛣️ Future Roadmap

- [ ] Social features and friend challenges
- [ ] Achievement system
- [ ] Customizable themes
- [ ] Export statistics
- [ ] Mobile app version
- [ ] Weekly and monthly quest planning -->

## 👨‍💻 Author:

**Kushal Bansal**

### Contact Details:
- 📧 Email: [[e-mail]](mailto:[e-mail])
<!--
## 📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details
-->
---

Built with ❤️ and determination to make habit-building fun and effective