IMPORTANT: Third-Social gathering Companies & Utilization Prices

This script integrates with a number of third-party providers. Accounts and any related charges are the client’s accountability and are NOT included within the buy worth:

Supabase — backend, database, auth, storage (free tier accessible, paid plans for manufacturing utilization)
Stripe — card funds (per-transaction charges set by Stripe)
PayPal — different fee supplier (per-transaction charges set by PayPal)
Google OAuth — social sign-in (free)
Google Gemini API — AI Sensible Matching & content material options (usage-based pricing)

You will want to offer your individual API keys and handle all related prices individually. Typical prices differ based mostly on utilization quantity.

TaskHive — The Full Multi-Tenant Service Market SaaS Script

TaskHive is a production-ready, multi-tenant Service Market + CRM SaaS script & net app constructed with React 18, Vite 5, TypeScript, Tailwind CSS, and Supabase. It ships with a full multi-role system (Admin, Supplier, Employees, Consumer), on the spot reserving, post-a-task workflow, real-time chat, Stripe & PayPal funds, AI-powered good matching, an installable PWA, a guided setup wizard, and a elegant, fully-responsive UI prepared for desktop, pill, and cell.

Whether or not you’re launching a handyman market, magnificence reserving platform, residence providers SaaS, freelance market, or a white-label vendor CRM, TaskHive provides you every thing you want out of the field — no backend coding required.

Reside Demo

Demo URL: https://taskhive.wrapcoders.com

Consumer: [email protected] / Client123!
Supplier: [email protected] / Provider123!
Admin: [email protected] / Admin123!

System Necessities

Node.js: 18.x – 22.x (LTS really helpful; examined on 18, 20, and 22)
Bundle Supervisor: npm 9+, pnpm 8+, or bun 1.0+
Database: Supabase / PostgreSQL 15+
Construct Output: Static SPA — deploys to any static host or CDN
Internet hosting: Vercel, Netlify, Cloudflare Pages, VPS (Nginx), cPanel, or Docker
RAM (construct): 2 GB minimal, 4 GB really helpful

Suitable Browsers

Google Chrome (newest 2 variations)
Mozilla Firefox (newest 2 variations)
Microsoft Edge (newest 2 variations)
Apple Safari 15+ (macOS & iOS)
Opera (newest)
Samsung Web (newest)
Courageous (newest)

IE11 isn’t supported.

App Overview

Multi-tenant structure with path-based routing (/:tenant-slug) and full tenant isolation through Postgres RLS
4 distinct consumer roles with devoted dashboards: Tremendous Admin, Supplier/Vendor, Employees, Consumer/Buyer
Constructed-in CRM for suppliers: prospects, leads, inquiries, bookings, earnings, evaluations
Installable Progressive Internet App (PWA) with offline assist and admin-controlled branding
Guided Setup Wizard for first-run set up, tenant creation, and onboarding
Actual-time every thing: chat, notifications, reserving updates, funds — powered by Supabase Realtime
AI-powered Sensible Matching utilizing Google Gemini to rank professionals for every job
Totally responsive throughout 1920px → 320px with no overflow, polished typography scaling, and mobile-first navigation

Key Options

Multi-Tenant SaaS Structure

Path-based multi-tenancy (/:tenant-slug) — host limitless manufacturers on one set up
Per-tenant branding: brand, favicon, major/accent colours, theme coloration, app identify
Tenant-scoped information with PostgreSQL Row-Stage Safety (RLS)
Database-level subscription plan enforcement through Postgres RPC
Default tenant fallback + tenant-aware authentication signup
Modular tenant touchdown pages with public-facing advertising sections

Multi-Function Person System

Tremendous Admin — Platform-wide management: customers, funds, disputes, refunds, withdrawals, content material, branding, Stripe config, audit log
Tenant Admin / Moderator — Tenant dashboard, refunds, withdrawals, content material moderation, vendor approvals, coupons
Supplier / Vendor / Agent — Companies, bookings, calendar, holidays, earnings, prospects, leads, inquiries, evaluations, employees administration, subscriptions, withdrawals, lead credit
Employees (sub-vendor) — Invitation-based onboarding, scoped vendor entry, devoted employees dashboard
Consumer / Buyer / Person — Browse, guide, submit duties, chat, pockets, evaluations, invoices, saved suppliers, disputes
Function aliases supported: Vendor, Agent, Driver, Freelancer, Creator, Buyer, Person, Proprietor, Writer

Authentication System

Electronic mail + password signup and login with Supabase Auth
Google OAuth + Apple Signal-In prepared
Forgot password & safe password reset move
Electronic mail verification earlier than sign-in
Profile completion gate for OAuth customers
Centralized usePermission() hook — single supply of fact for function gating
Safe consumer roles in a separate user_roles desk (no privilege escalation)
Safety-definer Postgres features (has_role) for protected RLS checks
Tenant-aware signup binds new customers to their tenant slug

Function-Primarily based Redirect System

Sensible post-login redirect based mostly on strongest function
Deep-link conscious — returns consumer to authentic vacation spot after auth
Pleasant toast messaging when accessing wrong-role areas
Admin-only routes protected with affirmation dialog
Employees handled as Supplier for UI gating (configurable)
Profile completion redirect for incomplete signups
Context-aware redirect prompts (e.g. “Proceed to your reserving after signing in”)

Setup Wizard (Set up Move)

4-step guided tenant onboarding wizard
First-run set up move with surroundings validation
Tenant registration with slug validation and uniqueness verify
Subscription tier choice throughout setup
Put up-install onboarding guidelines for brand new tenants
Branding setup instantly within the wizard (brand, colours, theme)
Auto-provisions pockets, profile, and default function on completion

PWA System (Installable App)

Installable on iOS, Android, Home windows, macOS, Linux
Offline assist through service employee (manufacturing builds)
Admin-controlled PWA branding: app identify, brief identify, icon, theme coloration, background coloration
Reside BrandingApplier + PwaBrandingApplier patch favicon, theme-color, and manifest at runtime
Apple contact icon, Android maskable icons, full manifest assist
Set up web page with platform-specific directions
NetworkFirst caching technique — by no means serves stale shells
Admin can rebrand the put in app with out redeploying

Supabase Integration

Auth — Electronic mail, OAuth (Google/Apple), password reset, e-mail verification
Database — PostgreSQL with full schema migrations included
RLS — Row-Stage Safety on each desk, tenant-isolated
Storage — 9 pre-configured buckets: avatars, portfolio, task-photos, chat-attachments, review-photos, branding, tenant-logos, verification-docs (non-public), receipts (non-public)
Realtime — Chat, notifications, bookings, funds stream dwell
Edge Capabilities — PDF receipts, e-mail sending, fee webhooks, AI matching
Cron jobs — Scheduled reminders through pg_cron
Audit log — Each admin motion recorded with actor, goal, and particulars

.env-controlled demo credentials system (gated by VITE_DEMO_MODE)
Three actual demo accounts: Admin, Supplier, Consumer (one-click login)
Devoted Demo Login web page with function selector playing cards
Compact demo widget embedded on the usual login web page
Aliased function labels (Vendor, Buyer, Moderator, Employees) all map to actual accounts
Auto-fill credentials button for fast guide testing
Demo UI & credentials by no means bundled in manufacturing builds — protected for shopper demos and QA

Desktop mega-menu with class looking
Pill adaptive header with collapsible sections
Cellular hamburger drawer with full nav tree
Sticky backside navigation for shopper cell dashboard
Sidebar navigation for admin & supplier dashboards
Examined throughout 1920, 1440, 1366, 1280, 1024, 768, 430, 390, 360, 320 px breakpoints
Zero horizontal overflow on any viewport
Easy transitions between breakpoints with optimized typography scaling

Reserving & Process System

Instantaneous Reserving with vendor availability calendar
Put up-a-Process move for open market bidding
Reusable VendorAvailabilityCalendar filtering booked/blocked/closed slots
Reserving actions: affirm, reschedule, cancel, mark full
Reschedule request move with vendor approval
Reserving coverage engine (cancellation home windows, deposits, refund guidelines)
Auto-generated invoices: INV-YYYYMMDD-ID
PDF receipts through Edge Perform, saved in non-public bucket with signed URLs
Calendar invite (.ics) era for confirmed bookings

Funds & Monetization

Stripe + PayPal integration
25% deposits with stability on completion
Platform fee system (configurable %)
Lead credit system for suppliers
Pockets system with transactions, withdrawals, refunds
Withdrawal cap enforcement on the database set off degree
Promo coupons with low cost varieties and utilization limits
Edge-function tax calculation (region-aware)
Admin earnings dashboard with fee breakdowns
Refund request workflow with admin approval
Cost historical past & bill downloads for shoppers

Actual-Time Chat

Supabase Realtime messaging (1-to-1 reserving chats)
File & picture attachments through Supabase Storage
Learn receipts and typing indicators
Per-channel distinctive IDs to forestall subscription leaks
Reserving-scoped chat threads
Unread message badges throughout the app

Evaluations & Rankings

Verified 5-star rankings (solely accomplished bookings can assessment)
Picture proof uploads
Vendor reply system
Combination ranking show on supplier profiles
“My Evaluations” web page for shoppers

AI Sensible Matching

Google Gemini-powered skilled rating for posted duties
AI rating badges on matched suppliers
Current matches historical past (auto-trimmed to final 5 per consumer)
Deliver-your-own Gemini API key (usage-based pricing)

Notifications System

Actual-time notification bell with badge rely
Per-tenant distinctive badge counts
Toast notifications for fast suggestions
Scheduled reminders through pg_cron
Per-user notification coverage preferences
Electronic mail + in-app supply channels
Customizable e-mail templates managed by admin

Inquiries & Lead Administration

Supplier inquiries inbox with standing monitoring
Consumer-to-provider inquiry varieties on service pages
Auto-conversion of inquiries into bookings
Lead credit score deduction per accepted inquiry

Invitation System

Vendor market invitations with auto-approval
Employees invites with role-scoped tokens
Electronic mail-matched invitee verification
Expiring invitation tokens with full audit log
Unknown function audit path for safety

Service Taxonomy

Hierarchical class system with icons
Database-linked vendor providers
Featured classes on touchdown web page
Class touchdown pages with web optimization meta
Lacking icon detection web page for admins

Tenant Branding & Theming

Admin Branding web page → CSS variables → dwell throughout app, receipts PDF, and e-mail templates
Mild/darkish mode with HSL token technique
Centralized typography system (.text-heading, .text-body, and so forth.)
Geist font with earthy inexperienced accent palette
Theme persistence per consumer
Emblem auto-switching for gentle/darkish mode

CMS & Content material

Constructed-in CMS for advertising pages (About, Phrases, Privateness, FAQ, and so forth.)
Contact messages inbox for admins
Dynamic web page rendering with web optimization meta
Electronic mail template editor
DOMPurify sanitization on all rich-text rendering (XSS-safe)

Documentation System

Full setup information (Supabase, env vars, deployment) in /docs/index.html
Auth E2E + visible QA checklists
Theme token contract & dark-mode function tokens documentation
Theming information
Changelog v1.0.0
Multi-role testing credentials documented
Inline JSDoc on hooks and utilities

Safety Options

Row-Stage Safety (RLS) insurance policies on each desk
Roles saved in separate desk — no privilege escalation
Server-side function checks through security-definer features
Hardened signup set off silently downgrades any admin/moderator self-elevation makes an attempt
Audit log for admin actions, refunds, withdrawals, settings, function modifications, branding edits
Withdrawal cap triggers forestall overdrafts at DB degree
Electronic mail-matched invitation verification
Non-public storage buckets with signed URLs (receipts, verification docs)
No client-side admin checks (no localStorage function storage)
CSRF-safe Supabase Auth + httpOnly session cookies
Hardcoded coloration scanner enforces design-token self-discipline at construct time

Efficiency Optimization

Vite 5 construct with route-level code splitting
Lazy-loaded pages (each dashboard web page cut up)
Bundle dimension monitoring with baseline monitoring and CI guard
Knip-pruned dependencies (zero unused code shipped)
Tree-shaken Lucide icons (per-icon chunks)
Picture lazy loading + responsive srcset
Memoized costly queries
Supabase question limits revered (1000 rows default)
Scroll-reveal animations with IntersectionObserver (no scroll listeners)

Deployment Information Abstract

One-click deploy to Vercel, Netlify, Cloudflare Pages
VPS deployment with Nginx (construct & serve dist/)
cPanel deployment (add dist/ to public_html)
Docker recipe included in /docs
Supabase challenge setup with included SQL migrations
Setting variable template supplied (.env.instance)
Stripe + PayPal configuration walkthrough
Customized area setup information
PWA publishing guidelines
Manufacturing construct: npm run construct / bun run construct
Edge Capabilities auto-deploy with the challenge

Use Circumstances — Who Is It For?

Residence Companies Market — Plumbers, electricians, cleaners, handymen
Magnificence & Wellness Reserving — Salons, spas, barbers, therapeutic massage therapists
Freelance Market — Designers, writers, builders, consultants
Native Companies SaaS — Tutoring, health coaching, pet care, images
White-Label Vendor CRM — Resell as a managed SaaS to native companies
Multi-Model Operators — Run a number of service manufacturers from one set up
Businesses — Spin up tenants for shoppers in minutes
Startup Founders — Launch an MVP market in days, not months
Discipline Service Corporations — Dispatch brokers, monitor jobs, acquire funds

Tech Stack

Frontend: React 18, Vite 5, TypeScript 5, Tailwind CSS v3
UI: shadcn/ui (curated), Radix primitives, Lucide icons, Framer Movement
Backend: Supabase (PostgreSQL, Auth, Storage, Realtime, Edge Capabilities)
Funds: Stripe, PayPal
AI: Google Gemini (carry your individual API key)
PWA: vite-plugin-pwa, Workbox
Testing: Vitest, Playwright E2E, axe accessibility

What’s Included

Full TypeScript supply code
Full Supabase SQL migrations
Edge Capabilities (PDF receipts, e-mail, funds)
Setup wizard + onboarding guidelines
3 ready-to-use demo accounts
Documentation portal (setup, deployment, theming, changelog) in /docs
QA checklists (auth, darkish mode, accessibility)
E2E check suites
6 months of free updates + precedence assist

Changelog

v1.0.0 — Preliminary Launch

Multi-tenant SaaS structure
4 consumer roles with devoted dashboards
Stripe + PayPal funds with deposits
Actual-time chat, notifications, bookings
AI good matching
Installable PWA with admin branding
Setup wizard + onboarding
Demo mode with one-click login (env-gated)
Totally responsive (1920px → 320px)
Full documentation portal

TaskHive is an entire, production-grade SaaS script you’ll be able to launch this weekend. Purchase as soon as, model it, deploy it, scale it.

Source

TaskHive – On-Demand & Handyman Services Marketplace JS Script

IMPORTANT: Third-Social gathering Companies & Utilization Prices