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

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

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

1. Clone the repo, npm install in web/
2. Create a Neon project, paste the pooled URL into .env.local
3. npx drizzle-kit migrate + npm run db:seed
4. npx tsx server.ts — admin at localhost:3000/admin
5. 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