Connect businesses (Buyers) with a global workforce (Workers) through role-based dashboards, dual-gateway payments (Stripe & SSLCommerz), automated PDF invoicing, and a real-time leaderboard.
Overview • Features • Architecture • Tech Stack • Getting Started • Structure • Contributing
TaskFlow streamlines micro-tasking from task creation to verified payout. Buyers fund their wallets and publish scoped tasks, Workers complete verified proofs to earn coins redeemable for cash, and Admins oversee users, submissions, withdrawals, and platform content from a unified glassmorphism interface.
Tip
Explore the live deployment at taskflow-ih.vercel.app — complete with role-based dashboards, dual payment gateways, and interactive animations.
|
|
|
|
flowchart LR
subgraph Roles["User Roles"]
W["👨💻 Worker"]
B["💼 Buyer"]
A["🛡️ Admin"]
end
subgraph App["Next.js 16 App Router"]
UI["Glassmorphism UI\nTailwind CSS 4 • Radix • GSAP • Framer Motion"]
API["REST API Routes & Apollo GraphQL"]
AUTH["NextAuth.js + Firebase Auth"]
end
subgraph Services["Data & Integrations"]
DB[("MongoDB\nMongoose ODM")]
PAY["Stripe & SSLCommerz"]
PDF["jsPDF Invoice Engine"]
MAIL["Nodemailer SMTP"]
end
W & B & A --> UI
UI --> AUTH
UI --> API
API --> DB
API --> PAY
API --> PDF
API --> MAIL
| Layer | Technologies |
|---|---|
| Framework | |
| Styling & UI | |
| Animations | |
| Backend & API | |
| Database | |
| Authentication | |
| State & Data | |
| Payments & Docs | |
| Validation & Mail |
Make sure you have the following ready before running locally:
- Node.js
v20.9+ - pnpm (recommended) or npm
- A MongoDB connection URI
- Firebase project credentials
- Stripe / SSLCommerz keys (for payment testing)
-
Clone the repository
git clone https://github.com/Injamhossan/task-flow.git cd task-flow -
Install dependencies
pnpm install # or npm install -
Configure environment variables
Create a
.envfile in the project root:Click to expand
.envtemplate# Database & Auth MONGODB_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net/<app> NEXTAUTH_URL=http://localhost:3000 NEXTAUTH_SECRET=your_nextauth_secret # Firebase Authentication NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_storage_bucket NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id # Payment Gateways STRIPE_SECRET_KEY=your_stripe_secret NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key SSLCOMMERZ_STORE_ID=your_store_id SSLCOMMERZ_STORE_PASSWORD=your_store_password@ssl NEXT_PUBLIC_APP_URL=http://localhost:3000 # Email (SMTP) EMAIL_SERVER_HOST=smtp.gmail.com EMAIL_SERVER_PORT=465 EMAIL_SERVER_SECURE=true EMAIL_SERVER_USER=your_email@gmail.com EMAIL_SERVER_PASSWORD=your_app_password
-
Start the development server
pnpm dev
-
Open in browser
Navigate to
http://localhost:3000.
| Command | Description |
|---|---|
pnpm dev |
Starts the Next.js development server with Turbopack |
pnpm build |
Builds the production application bundle |
pnpm start |
Runs the compiled production server |
pnpm lint |
Lints the codebase with ESLint |
src/
├── app/ # Next.js App Router pages & serverless API routes
│ ├── api/ # REST & GraphQL endpoints (auth, tasks, payments, ssl, etc.)
│ ├── blog/ # Public blog listing & article detail pages
│ ├── dashboard/ # Protected role-based dashboards (Admin, Buyer, Worker)
│ └── page.jsx # Landing page
├── assets/ # Static brand & payment logos
├── auth/ # Firebase client configuration
├── components/ # Shared UI & marketing sections
│ ├── Dashboard/ # Admin, Buyer, Worker dashboard views & sidebar
│ └── ui/ # Reusable Radix / Shadcn primitives
├── lib/ # Apollo client, MongoDB connector, email & helpers
├── models/ # Mongoose schemas (User, Task, Submission, Payment, etc.)
├── redux/ # Redux Toolkit store & auth/notification slices
└── style/ # Global Tailwind CSS styles
Contributions, issues, and feature requests are always welcome!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m "feat: add amazing feature") - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Distributed under the MIT License. See the repository for details.
Made with ❤️ by Injamhossan