TaskMate is a task coordination system built to model a hostel-level micro-economy, where users can post tasks, accept work, and complete them through a structured and secure workflow. Tasks move through strictly controlled states and user actions are governed by role-based constraints and validated transitions.
In hostel environments, students frequently need help with small tasks like cooking, cleaning, errands, or academic work.
However, there is no structured, reliable system to:
- Request help
- Find trustworthy people
- Track task progress
- Ensure accountability
TaskMate provides a controlled, state-driven system where:
- Users can post and accept tasks
- Each task follows a strict lifecycle
- Actions are role-restricted (Creator vs Acceptor)
- Communication is secure and conditional
- Payments are tracked before closure
TaskMate is built as a state-driven workflow system with strict validation.
open → accepted → in_progress → work_done → payment_pending → payment_received → closed
- No step skipping
- No unauthorized actions
- Clear ownership at each stage
- Automatic task closure after payment
- Role-based API protection (Creator / Acceptor)
- Chat access only after task acceptance
- Controlled state transitions via backend validation
- User posts a task with details (category, price, deadline, location)
- Another user accepts the task
- A private chat channel is unlocked between both users
- Task progresses through lifecycle stages
- Creator selects payment method
- Acceptor confirms payment
- Task is marked as closed by the creator.
- Google Authentication using NextAuth
- Secure session handling
- Title, description, category, price
- Hostel & room number
- Optional deadline (date + time)
- Auto-attached user details (name, email, avatar)
- Posted tasks (as Creator)
- Accepted tasks (as Acceptor)
- Active tasks
- Earnings tracking
- Real-time lifecycle updates
- Filter by category & hostel
- Sort by nearest deadline
- Expired tasks auto-hidden
- "Expiring Soon" indicators
- Chat enabled only after task acceptance
- Online/offline status visibility
- Payment methods: Cash / UPI
- Payment status tracking
- Next.js (App Router)
- React
- TypeScript
- Tailwind CSS
- Next.js API Routes
- Firebase Firestore
- Firebase Admin SDK
- NextAuth.js
- Google Provider
- Vercel
- Role-based API protection
- Strict lifecycle validation system
- State-driven architecture
- Firestore timestamp serialization handling
- Defensive UI (fallbacks, expired task handling)
- Server-side filtering for accuracy and performance
- Ratings & trust system
- User analytics (earnings, completion rate)
- Smart task recommendations
- Real payment gateway integration (Razorpay/Stripe)
https://task-mate-five-eta.vercel.app/
Manavi Sharma
NIT Hamirpur