LocatePro AI-Powered Store Locator & Territory Management SaaS Platform

IMPORTANT: AI Usage Costs

This platform uses AI-powered features (content generation, subject line suggestions, analytics insights) that connect to external AI providers. AI API usage costs are NOT included in the purchase price. You will need to provide your own API keys and manage associated costs separately. Typical costs vary based on usage volume.

Live Demo

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

Admin: admin@demo.com / Admin123!
User: user@demo.com / User123!

Installation & Customization Services Available

Thank you for choosing our product!

We are happy to offer professional installation and customization services to ensure your application runs smoothly and meets your business requirements.

Our Services Include:

• Full App Installation & Setup
• Server Configuration
• Bug Fixing & Optimization
• Feature Customization
• UI/UX Modifications
• Deployment Support

WhatsApp: Chat with us
Email: wrapcoders@gmail.com

Feel free to contact us anytime — we’re always here to support you!

LocatePro — The Ultimate AI-Powered Store Locator & Territory Management Platform

LocatePro is a production-ready, enterprise-grade SaaS platform for businesses that need to manage store locations, optimize service territories, book appointments, and make data-driven expansion decisions — all powered by AI and built on a modern React + Supabase stack.

Whether you're managing a franchise network, a chain of retail outlets, service centers, or warehouses, LocatePro gives you everything you need to visualize, analyze, and grow your physical presence — out of the box.

🚀 Why LocatePro?

• Not just a store locator — it's a complete spatial intelligence platform.
• AI-driven insights — natural language search, coverage gap analysis, and expansion simulations powered by Google Gemini & OpenAI.
• Multi-tenant SaaS architecture — deploy once, serve unlimited organizations with full data isolation.
• Production-ready — authentication, payments, RLS security policies, and real-time updates included.
• Modern tech stack — React 18, TypeScript, Tailwind CSS, Supabase, Vite, and Framer Motion.

📦 Core Modules

1. AI-Powered Store Locator

A beautiful, responsive store locator with Google Maps integration that goes far beyond simple pin-dropping:

• Natural Language AI Search — Users can search with queries like "Find a branch near downtown with parking" instead of rigid filters.
• Smart Autocomplete — Address autocomplete powered by Google Places API with fuzzy matching fallback.
• Geolocation Detection — Automatically detect user location and sort results by proximity.
• Advanced Filtering — Filter by category (retail, warehouse, service center, headquarters, branch), services, city, and radius.
• Interactive Street View — Full Google Street View integration with a dedicated modal viewer.
• Location Detail Pages — Rich detail pages with photo galleries, opening hours, services, reviews, and nearby locations.
• Favorites & Recently Viewed — Authenticated users can save favorites and revisit browsing history.
• Share Menu — Share locations via native share, copy link, or direct URL.
• AI-Powered Recommendations — Smart store recommendations based on user behavior and preferences.
• Embeddable Widget — Generate a fully customizable iframe widget to embed the locator on any website with a visual configurator.

2. Store Zone Management

Define, visualize, and manage service coverage zones with three flexible territory types:

• Polygon Zones — Draw custom polygons directly on the map using Google Maps Drawing Manager. Define precise, irregular boundaries for urban areas or complex territories.
• Radius Zones — Click-to-place circular zones with configurable radius in miles. Perfect for service areas around a central location.
• Zip Code Zones — Define territories by comma-separated zip/postal codes for administrative boundary alignment.
• Color-Coded Visualization — Each zone gets a unique color for clear map differentiation.
• Overlap Detection — Automatic detection of overlapping zones between radius-based and zip code–based territories.
• Team & User Assignment — Assign zones to specific team members or teams for accountability.
• Priority Levels — Set priority rankings for zone conflict resolution.

3. AI-Powered Spatial Analytics

Make data-driven decisions about where to expand with powerful analytics tools:

• Coverage Analysis (AI) — One-click AI analysis that evaluates your entire zone network, identifies coverage gaps, suggests optimal new locations with coordinates, detects overlaps, and provides priority action items.
• Demand Heatmap — Visualize service demand intensity across your territory with configurable heatmap layers. Filter by demand type and date range.
• "What-If" Simulations — Place hypothetical new locations on the map and instantly see projected coverage improvement, demand capture percentage, and AI-generated recommendations on whether to proceed.
• Scenario Comparison — Compare before/after metrics when simulating new branch placements.
• Demand Data Tracking — Record and analyze service requests by geographic origin with weighted demand points.

4. Appointment Booking System

A full-featured appointment scheduling system integrated with your store locations:

• Per-Location Booking Settings — Configure slot intervals, advance booking days, minimum notice hours, buffer times, and max appointments per slot individually for each location.
• Service-Based Scheduling — Define services with custom durations for each location. Customers select a service when booking.
• Appointment Lifecycle — Full status management: pending → confirmed → completed (or cancelled/no-show).
• Admin Dashboard — View, confirm, cancel, and add notes to appointments. Filter by status and date.
• Guest & Authenticated Booking — Customers can book without an account, or sign in for history tracking.
• WhatsApp Notifications — Send appointment confirmations, reminders, and updates via WhatsApp with phone verification.
• Email Notifications — Automated email notifications for new bookings and status changes.

5. Reviews & Ratings

Build trust with a comprehensive review system:

• Star Ratings & Written Reviews — Authenticated users can rate and review locations with titles and detailed content.
• "Helpful" Voting — Community-driven review ranking with helpful/unhelpful votes.
• Review Reporting — Users can flag inappropriate reviews with categorized reasons and details.
• Admin Moderation — Dashboard for reviewing reported content with approve/dismiss actions.
• Average Rating Display — Aggregate ratings shown on location cards, detail pages, and search results.

6. Store Registration Portal

Allow businesses to submit their stores for inclusion in your directory:

• Public Submission Form — Comprehensive form with business details, contact info, address with geocoding, category selection, and services.
• Admin Review Workflow — Submissions queue with approve/reject actions and reviewer tracking.
• Auto-Geocoding — Submitted addresses are automatically geocoded for map placement.
• Email Notifications — Automated notifications to admins when new submissions arrive.

🏢 Enterprise SaaS Features

Multi-Tenant Architecture

• Organization-Based Isolation — Each tenant (organization) has completely isolated data. All tables enforce organization-level Row Level Security (RLS) policies.
• Role-Based Access Control (RBAC) — Two roles: `admin` (full management) and `staff` (operational access).
• Team Management — Invite team members, assign roles, and manage your organization's staff from the dashboard.
• Organization Profiles — Custom organization name, logo, and plan-based feature limits.

Payment & Billing

• Stripe Integration — Full Stripe checkout, subscription management, webhooks, invoicing, and customer portal.
• PayPal Integration — PayPal order creation and capture for one-time and recurring payments.
• Cryptocurrency Payments — Coinbase Commerce integration for crypto checkout with webhook verification.
• Subscription Plans — Three tiers (Starter, Professional, Enterprise) with configurable location limits and feature gates.
• Free Trial System — Configurable trial periods with expiration banners and upgrade prompts.
• Invoice Management — View, download, and email invoices from the admin dashboard.
• Payment Gateway Settings — Configure API keys, toggle live/test mode, and enable/disable gateways per organization.

Authentication & Security

• Email/Password Authentication — Full signup, login, email verification, forgot password, and password reset flows.
• Row Level Security (RLS) — Every table has granular RLS policies ensuring users can only access data within their organization.
• Protected Routes — Client-side route guards with automatic redirect to login.
• Setup Guard — First-run setup wizard that configures the application before any access is granted.

🎨 UI & Design

• Responsive Design — Fully responsive across desktop, tablet, and mobile devices.
• Dark & Light Themes — System-aware theme switching with manual override. Persisted per user profile.
• Framer Motion Animations — Smooth page transitions, card animations, and micro-interactions throughout.
• shadcn/ui Component Library — Built entirely on Radix UI primitives with Tailwind CSS styling for maximum customizability.
• Semantic Design Tokens — Fully tokenized color system via CSS custom properties for easy theming and white-labeling.
• Accessible — ARIA labels, keyboard navigation, and screen reader support via Radix UI.

📊 Admin Dashboard

A comprehensive management dashboard with the following pages:

• Overview — Key metrics, recent activity, and quick actions at a glance.
• Locations Management — Full CRUD for store locations with address autocomplete, map preview, photo gallery management, services configuration, and booking settings.
• Store Zones — Visual zone management with map-based creation, overlap detection, and AI coverage analysis.
• Analytics — Search trends, top locations, user activity, and view tracking with interactive Recharts visualizations.
• Appointments — Booking management with status filters, calendar view, and notification controls.
• Submissions — Review and approve/reject store registration requests.
• Reported Reviews — Content moderation queue for flagged user reviews.
• Contact Messages — Inbox for public contact form submissions.
• Team — User and role management for your organization.
• Invoices — Payment history and invoice management.
• Profile — User profile, display name, theme preferences, and amenity preferences.
• Settings — System configuration, payment gateway setup, and installation reset.

🔧 Setup Wizard

A guided first-run setup wizard ensures your instance is configured correctly:

1. Environment Check — Validates Supabase connection and required environment variables.
2. Admin Account — Creates the first administrator account.
3. App Identity — Configure application name, branding, and logo.
4. System Settings — Set default map center, radius, units, and locator behavior.
5. Email Configuration — Configure SMTP settings for transactional emails.
6. Security — Review and confirm security settings.
7. Complete — Summary and launch.

🌐 Public Pages

• Landing Page — Marketing homepage with hero section, feature highlights, and call-to-action.
• Store Locator — Public-facing locator with search, filters, and map view.
• Location Detail — Individual store pages with photos, hours, reviews, nearby locations, and appointment booking.
• Pricing — Plan comparison page with feature matrix.
• Blog — Content marketing pages with article listings and individual post views.
• About — Company information page.
• Contact — Public contact form with validation.
• Store Registration — Public form for businesses to submit their locations.

📁 Edge Functions (Backend)

LocatePro includes 20+ Supabase Edge Functions for serverless backend logic:

• `ai-smart-search` — Natural language location search
• `analyze-coverage` — AI-powered territory coverage analysis & What-If simulations
• `get-store-recommendations` — Personalized store recommendations
• `create-checkout-session` — Stripe checkout
• `stripe-webhook` — Stripe event processing
• `create-paypal-checkout` / `capture-paypal-order` — PayPal integration
• `create-coinbase-checkout` / `coinbase-webhook` — Crypto payments
• `manage-subscription` — Subscription lifecycle management
• `start-free-trial` — Trial activation
• `send-appointment-notification` — Appointment emails
• `send-whatsapp` — WhatsApp messaging via Twilio
• `send-contact-notification` — Contact form alerts
• `send-submission-notification` — Store submission alerts
• `send-invoice-email` — Invoice delivery
• `scrape-store-locations` — Bulk store import via web scraping
• `get-maps-api-key` — Secure Maps API key retrieval
• `complete-setup` / `save-setup-config` — Setup wizard backend
• `reset-installation` / `request-reset-confirmation` — Factory reset
• `create-demo-users` — Demo data seeding

📝 Database Schema

LocatePro uses 20+ PostgreSQL tables with comprehensive Row Level Security:

• `organizations` — Multi-tenant organization management
• `user_roles` — RBAC with admin/staff roles
• `profiles` — User profiles with theme & notification preferences
• `locations` — Store/branch data with geocoding
• `location_photos` — Photo gallery with ordering
• `location_services` — Per-location service definitions
• `location_booking_settings` — Appointment configuration
• `territories` — Store zones (polygon/radius/zipcode)
• `territory_demand` — Demand heatmap data points
• `appointments` — Booking records with full lifecycle
• `reviews` — User ratings & reviews
• `review_helpfuls` — Review voting
• `review_reports` — Content moderation
• `favorites` — User-saved locations
• `user_location_views` — Browsing history & analytics
• `store_submissions` — Public store registration
• `subscriptions` — Subscription management
• `payments` — Payment records
• `payment_gateway_settings` — Gateway configuration
• `contact_messages` — Contact form inbox
• `notification_logs` — Notification audit trail
• `notification_preferences` — WhatsApp preferences
• `system_config` — Application settings

📖 Documentation

LocatePro includes comprehensive developer documentation covering:

• Complete installation & setup guide
• Architecture overview with component hierarchy
• Database schema reference with all tables and relationships
• Store zone types (Polygon, Radius, Zip Code) with code examples
• AI features configuration and usage
• Payment gateway setup (Stripe, PayPal, Coinbase)
• Embeddable widget integration guide
• API reference for all Edge Functions
• Security model and RLS policy documentation
• Customization & theming guide

✅ What You Get

• Full source code (React + TypeScript)
• 20+ Supabase Edge Functions
• Complete database migrations
• Developer documentation (HTML)
• Setup wizard for easy deployment
• Demo data seeding
• Free updates & bug fixes

📋 Requirements

• Node.js 18+ or Bun
• Supabase account (free tier works)
• Google Maps API key
• Stripe account (for payments, optional)
• Twilio account (for WhatsApp, optional)

🔄 Changelog

v1.0.0 — Initial Release

• AI-powered store locator with natural language search
• Store zone management (polygon, radius, zip code)
• Coverage analysis with What-If simulations
• Demand heatmap visualization
• Appointment booking with WhatsApp notifications
• Multi-tenant SaaS with RBAC
• Stripe, PayPal, and Crypto payment integration
• Reviews, ratings, and content moderation
• Embeddable widget generator
• Comprehensive admin dashboard
• Dark/light theme support
• Full documentation

Installation & Customization Services Available

Thank you for choosing our product!

We are happy to offer professional installation and customization services to ensure your application runs smoothly and meets your business requirements.

Our Services Include:

• Full App Installation & Setup
• Server Configuration
• Bug Fixing & Optimization
• Feature Customization
• UI/UX Modifications
• Deployment Support

WhatsApp: Chat with us
Email: wrapcoders@gmail.com

Feel free to contact us anytime — we’re always here to support you!