Description
TaskHive – AI-Powered Handyman Services Marketplace SaaS Script
TaskHive – AI-Powered Handyman Services Marketplace SaaS Script 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.
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)
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
Authentication System
- Email + password signup and login with Supabase Auth
- Google OAuth + Apple Sign-In ready
- Forgot password & secure password reset flow
- Email verification before sign-in
- Profile completion gate for OAuth users
- Centralized usePermission() hook — single source of truth for role gating
- Secure user roles in a separate user_roles table (no privilege escalation)
- Security-definer Postgres functions (has_role) for safe RLS checks
- Tenant-aware signup binds new users to their tenant slug
Role-Based Redirect System
- Smart post-login redirect based on strongest role
- Deep-link aware — returns user to original destination after auth
- Friendly toast messaging when accessing wrong-role areas
- Admin-only routes protected with confirmation dialog
- Staff treated as Provider for UI gating (configurable)
- Profile completion redirect for incomplete signups
- Context-aware redirect prompts (e.g. “Continue to your booking after signing in”)
Setup Wizard (Installation Flow)
- 4-step guided tenant onboarding wizard
- First-run installation flow with environment validation
- Tenant registration with slug validation and uniqueness check
- Subscription tier selection during setup
- Post-install onboarding checklist for new tenants
- Branding setup directly in the wizard (logo, colors, theme)
- Auto-provisions wallet, profile, and default role on completion
PWA System (Installable App)
- Installable on iOS, Android, Windows, macOS, Linux
- Offline support via service worker (production builds)
- Admin-controlled PWA branding: app name, short name, icon, theme color, background color
- Live BrandingApplier + PwaBrandingApplier patch favicon, theme-color, and manifest at runtime
- Apple touch icon, Android maskable icons, full manifest support
- Install page with platform-specific instructions
- NetworkFirst caching strategy — never serves stale shells
- Admin can rebrand the installed app without redeploying
