ServeAI | the complete on-demand services platform

A 3-in-1 package that ships everything you need to launch a location-based service marketplace. One Next.js backend and admin panel, two polished Flutter apps (customer and provider), wired end-to-end with Stripe, Firebase, Socket.IO real-time, and an AI price estimator. Domain-agnostic — works for home cleaning, handyman, beauty & wellness, car detailing, tutoring, pet care, or any on-demand marketplace you want to build.

Important: third-party services and additional costs

This item’s purchase price covers the source code only. ServeAI integrates with several external services that are not included in the purchase price and may incur additional fees, billed directly to you by their respective providers under their own pricing and terms:

OpenAI — pay-per-token charges if you enable the OpenAI provider for AI price estimation.
Google Gemini — pay-per-token charges if you enable the Gemini provider for AI price estimation.
Google Maps Platform — usage-based charges for Maps SDK, Geocoding, Places, and Directions APIs.
Cloudflare R2 — storage and (egress-free) usage charges for image and document uploads.
Resend — per-email charges above the free tier for transactional and broadcast email.
Neon — serverless Postgres usage charges above the free tier.
Stripe — standard Stripe Connect transaction and payout fees on real (non-mock) payments.
Firebase — Cloud Messaging is free; other Firebase services may incur charges if you enable them.
Railway (or any other host) — hosting fees for the Next.js + Socket.IO server.

You are responsible for creating, configuring, and paying for any third-party accounts you choose to use. AI features can be disabled entirely via a runtime feature flag, and payments can run in mock mode for evaluation without any Stripe account.

Live demo

Admin panel: https://serveai.devsnack.dev/admin — login admin@serveai.dev / password123
Customer app APK: Download
Provider app APK: Download

Booking flow

Categorized catalog with hierarchical categories + service packages + add-ons
5-step booking wizard — package → schedule → address → review → confirm
Coupon codes (flat or percentage, with expiry and usage limits)
Before/after photo uploads on each booking
Reschedule + cancel with automatic refunds
Full booking state machine with enforced transitions

Payments — pluggable, not locked in

Stripe Connect Express accounts for providers — auto-payouts on completion
Manual-capture PaymentIntents + webhooks already wired
Three methods supported: Card, Wallet, Cash
Clean PaymentProvider abstraction — add PayPal, Razorpay, local gateways without touching call sites
Mock mode for dev: runs the full flow end-to-end with no Stripe account
Refunds, commission accounting, and payout requests all implemented

Agency feature

Provider can create an agency and invite workers by phone
Owner dispatches incoming jobs to any approved worker
Configurable owner-cut percentage (e.g. owner keeps 10% of worker earnings)
Ledger reconciles to the cent — agency cut rounded before subtracting worker net

AI — admin-switchable

AI price estimation in the customer app — “how much would this cost?”
Switch between OpenAI and Google Gemini at runtime from the admin panel
Global on/off via a feature flag

Real-time

Socket.IO on a custom Next.js server
Authenticated handshake + per-booking room authorization (customer / assigned provider / agency owner only)
Live provider location while en route
In-booking chat with typing indicators + read receipts
Live status transitions pushed to all parties

Notifications

FCM push for Android + iOS — tap to deep-link into the right booking
In-app notification inbox with read/unread state
FCM tokens register on login, rotate on refresh, unregister on logout (no push spam to sold devices)
Admin broadcast notifications to all customers or providers

Admin panel (20 pages)

Dashboard with revenue + booking charts
Bookings oversight with full audit trail
Services + categories + packages + add-ons editor with image uploads
Providers directory with approvals + document viewer
Customers directory with wallet adjustments + booking history
Agencies directory with commission overrides
Coupons editor
Payouts queue — approve, reject, transfer
Transactions ledger
Reviews moderation with admin replies
Feature flags + maintenance mode — instant toggle, no redeploy
Reports + email composer (Resend) + push broadcast

Design system

Editorial, asymmetric aesthetic — borderless sectioning, ambient shadows only, no pure-black palette
Plus Jakarta Sans throughout
Consistent 20px radii and color tokens between web and both mobile apps
Ready-made brand swaps — change three palette variables to rebrand the whole product

Tech stack

Layer	Technology
Backend	Next.js 16 (App Router), TypeScript
Database	PostgreSQL on Neon, Drizzle ORM
Real-time	Socket.IO on a custom Next server
Admin auth	NextAuth v5 with Drizzle adapter
Mobile auth	Firebase Admin → platform JWT
Payments	Stripe Connect (extensible PaymentProvider)
AI	Vercel AI SDK (OpenAI / Gemini)
Object storage	Cloudflare R2 (S3-compatible)
Email	Resend
Mobile	Flutter 3 + Riverpod 2 + GoRouter + Dio

What’s included

Full source for all three applications — no paywalled “pro” version
Drizzle schema + migrations (runs automatically on Railway boot)
Seed script with a demo admin, providers, customer, and sample bookings
270+ automated tests (Vitest on backend + flutter_test on both mobile apps)
Dockerfile + railway.json — one-click deploy to Railway
Complete documentation (this quick-start + full architecture reference)
Secrets workflow — build-time Google Maps key injection, release keystore wiring, Stripe mock mode
Brand asset folders and launcher icon / splash config for both Flutter apps
6 months of seller support

Quick setup

Clone the repo, npm install in web/
Create a Neon project, paste the pooled URL into .env.local
npx drizzle-kit migrate + npm run db:seed
npx tsx server.ts — admin at localhost:3000/admin
flutter run each mobile app pointing at the backend

Full step-by-step in the included README.md and docs/quick-start.html. Mock mode runs the full flow with no Firebase or Stripe account.

Requirements

Node.js 20+ and npm 10+
Flutter 3.x (Dart SDK ≥ 3.11)
JDK 17 + Android Studio for Android
Xcode 15+ for iOS
Neon account (free tier is fine)
Firebase project (free tier)
Cloudflare account for R2 object storage
Google Maps API key
Stripe account (optional for evaluation — mock mode runs without)
OpenAI or Gemini key (optional — AI can be disabled via feature flag)

Support

Every purchase includes 6 months of buyer support for setup questions and bug fixes. Custom feature work quoted separately.

Email: devsnack26@gmail.com
WhatsApp: +855 96 741 3911

Changelog

v0.1.0 — Initial release.

Next.js 16 backend + Drizzle ORM on Neon
Customer + Provider Flutter apps
Admin panel with 20 pages
Stripe Connect + mock mode
Real-time tracking, chat, status updates
FCM push notifications
AI price estimation (OpenAI / Gemini)
Agency commission-split feature
Wallet, coupons, referrals
Feature flags + maintenance mode
270+ automated tests

ServeAI | on-Demand Services Marketplace Full Application (Flutter and Next.js)