TaskHive – AI-Powered Handyman Services Marketplace SaaS Script

This script integrates with several third-party services. Accounts and any associated fees are the buyer’s responsibility and are NOT included in the purchase price:

• Supabase — backend, database, auth, storage (free tier available, paid plans for production usage)
• Stripe — card payments (per-transaction fees set by Stripe)
• PayPal — alternative payment provider (per-transaction fees set by PayPal)
• Google OAuth — social sign-in (free)
• Google Gemini API — AI Smart Matching & content suggestions (usage-based pricing)

You will need to provide your own API keys and manage all associated costs separately. Typical costs vary based on usage volume.

TaskHive is a production-ready, multi-tenant Service Marketplace + CRM SaaS script & web app built with React 18, Vite 5, TypeScript, Tailwind CSS, and Supabase. It ships with a full multi-role system (Admin, Provider, Staff, Client), instant booking, post-a-task workflow, real-time chat, Stripe & PayPal payments, AI-powered smart matching, an installable PWA, a guided setup wizard, and a polished, fully-responsive UI ready for desktop, tablet, and mobile.

Whether you’re launching a handyman marketplace, beauty booking platform, home services SaaS, freelance marketplace, or a white-label vendor CRM, TaskHive gives you everything you need out of the box — no backend coding required.

System Requirements

• Node.js: 18.x – 22.x (LTS recommended; tested on 18, 20, and 22)
• Package Manager: npm 9+, pnpm 8+, or bun 1.0+
• Database: Supabase / PostgreSQL 15+
• Build Output: Static SPA — deploys to any static host or CDN
• Hosting: Vercel, Netlify, Cloudflare Pages, VPS (Nginx), cPanel, or Docker
• RAM (build): 2 GB minimum, 4 GB recommended

Compatible Browsers

• Google Chrome (latest 2 versions)
• Mozilla Firefox (latest 2 versions)
• Microsoft Edge (latest 2 versions)
• Apple Safari 15+ (macOS & iOS)
• Opera (latest)
• Samsung Internet (latest)
• Brave (latest)

IE11 is not supported.

App Overview

• Multi-tenant architecture with path-based routing (/:tenant-slug) and full tenant isolation via Postgres RLS
• 4 distinct user roles with dedicated dashboards: Super Admin, Provider/Vendor, Staff, Client/Customer
• Built-in CRM for providers: customers, leads, inquiries, bookings, earnings, reviews
• Installable Progressive Web App (PWA) with offline support and admin-controlled branding
• Guided Setup Wizard for first-run installation, tenant creation, and onboarding
• Real-time everything: chat, notifications, booking updates, payments — powered by Supabase Realtime
• AI-powered Smart Matching using Google Gemini to rank professionals for each task
• Fully responsive across 1920px → 320px with no overflow, polished typography scaling, and mobile-first navigation

Key Features

Multi-Tenant SaaS Architecture

• Path-based multi-tenancy (/:tenant-slug) — host unlimited brands on one install
• Per-tenant branding: logo, favicon, primary/accent colors, theme color, app name
• Tenant-scoped data with PostgreSQL Row-Level Security (RLS)
• Database-level subscription plan enforcement via Postgres RPC
• Default tenant fallback + tenant-aware authentication signup
• Modular tenant landing pages with public-facing marketing sections

Multi-Role User System

• Super Admin — Platform-wide control: users, payments, disputes, refunds, withdrawals, content, branding, Stripe config, audit log
• Tenant Admin / Moderator — Tenant dashboard, refunds, withdrawals, content moderation, vendor approvals, coupons
• Provider / Vendor / Agent — Services, bookings, calendar, holidays, earnings, customers, leads, inquiries, reviews, staff management, subscriptions, withdrawals, lead credits
• Staff (sub-vendor) — Invitation-based onboarding, scoped vendor access, dedicated staff dashboard
• Client / Customer / User — Browse, book, post tasks, chat, wallet, reviews, invoices, saved providers, disputes
• Role aliases supported: Vendor, Agent, Driver, Freelancer, Creator, Customer, User, Owner, Publisher