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