Skip to content
InjamhossanPublic

About

TaskFlow is a modern, full-stack micro-tasking platform that connects businesses ("Buyers") with a global workforce ("Workers"). Buyers post simple tasks, and Workers earn real money by completing them.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

⚡ TaskFlow

Modern Full-Stack Micro-Tasking Marketplace

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.

Live Demo Next.js 16.4 React 19 Tailwind CSS 4 MongoDB GraphQL MIT License

Overview • Features • Architecture • Tech Stack • Getting Started • Structure • Contributing


TaskFlow Platform Preview

🌟 Overview

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.


✨ Key Features

👨‍💻 For Workers

  • Earn Coins — Browse available micro-tasks and submit proof of completion.
  • Fast Withdrawals — Convert earned coins to real currency with secure payout requests.
  • Submission Tracking — Monitor work status in real time (Pending, Approved, Rejected).
  • Top Earners Leaderboard — Compete for top rankings across the platform.

💼 For Buyers

  • Task Publishing — Create tasks with clear instructions, rewards, and worker limits.
  • Proof Review — Inspect worker submissions and approve or reject proofs effortlessly.
  • Dual-Gateway Wallet — Purchase coins via Stripe (International) or SSLCommerz (Bangladesh).
  • PDF Invoicing — Review payment history and download professional PDF invoices via jsPDF.

🛡️ For Admins

  • User Management — View platform users, update roles, and manage accounts.
  • Task Oversight — Audit active tasks and submission pipelines platform-wide.
  • Withdrawal Processing — Review and settle worker cash-out requests.
  • Blog CMS — Create, edit, and publish platform news and articles.

📰 Platform & Compliance

  • Notifications & OTP — Real-time user alerts and email-backed verification flows.
  • Integrated Blog & Docs — Public blog, FAQs, pricing, and API documentation pages.
  • Legal Readiness — Dedicated Privacy Policy, Terms, Cookies, and Data Deletion pages.
  • Secure Contact — Direct contact form backed by SMTP email delivery.

🧭 Architecture

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
Loading

🛠️ Tech Stack

Layer Technologies
Framework Next.js React
Styling & UI Tailwind CSS Radix UI Shadcn/UI Lucide
Animations GSAP Framer Motion Lenis
Backend & API Next.js API GraphQL Apollo Server
Database MongoDB Mongoose
Authentication NextAuth.js Firebase
State & Data TanStack Query Apollo Client Redux Toolkit
Payments & Docs Stripe SSLCommerz jsPDF
Validation & Mail Zod Nodemailer

🚀 Getting Started

Prerequisites

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)

Installation

  1. Clone the repository

    git clone https://github.com/Injamhossan/task-flow.git
    cd task-flow
  2. Install dependencies

    pnpm install
    # or
    npm install
  3. Configure environment variables

    Create a .env file in the project root:

    Click to expand .env template
    # 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
  4. Start the development server

    pnpm dev
  5. Open in browser

    Navigate to http://localhost:3000.

Available Scripts

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

📂 Project Structure

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

🤝 Contributing

Contributions, issues, and feature requests are always welcome!

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m "feat: add amazing feature")
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

Distributed under the MIT License. See the repository for details.


Made with ❤️ by Injamhossan

⬆ Back to Top

About

TaskFlow is a modern, full-stack micro-tasking platform that connects businesses ("Buyers") with a global workforce ("Workers"). Buyers post simple tasks, and Workers earn real money by completing them.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages