FreshCut | AI-Powered Salon Booking React Native CLI App

FreshCut | AI-Powered Salon Booking React Native CLI App

FreshCut is a production-ready, AI-powered multi-tenant salon, barbershop, and beauty appointment booking platform. Engineered with a scalable Node.js & Express REST API, MongoDB (Mongoose), and 3 independent pure React Native CLI mobile applications (Customer App, Salon Owner App, and Super Admin App), FreshCut delivers an ultra-responsive, modern mobile experience built with TypeScript, Redux Toolkit, NativeWind v4 (Tailwind CSS), and full New Architecture (Fabric & TurboModules) support without any Expo runtime dependencies.

Demo APKs (Download & Test)

Test the applications directly on your Android device. Use the demo credentials provided below to explore each app’s complete functionality.

• User App (Customer): Download User App APK
  Demo Email: sa1506758@gmail.com | Password: 12345678
• Owner App (Salon Manager): Download Owner App APK
  Demo Email: shakeelsoftwaredev@gmail.com | Password: 12345678
• Admin App (Super Admin): Download Admin App APK
  Demo Email: shakeelahmad181414@gmail.com | Password: 12345678

⚠️ AI Disclosure (Envato Policy Compliance)

AI-Assisted Development: In accordance with Envato’s AI disclosure policy, the author discloses that portions of this product’s codebase were developed with the assistance of AI coding tools (Google Gemini). All generated code has been thoroughly reviewed, tested, debugged, and validated by the author to ensure production quality and correctness.

Runtime AI Features: This application integrates AI inference services (Groq Cloud LLMs) as runtime features for end-users. These are application features, not development tools — see the detailed disclosure below.

Stripe Checkout Integration: The complete source code for Stripe Payment Sheets checkout, booking payments, and platform commission management is included in the package. Buyers receive full control over all features under the Regular license with no external dependencies beyond the Stripe SDK.

⚠️ AI Features & API Usage Disclosure

In accordance with Envato’s item quality and disclosure requirements, please be advised that FreshCut leverages Artificial Intelligence to power core stylistic and grooming recommendations. An active API key from Groq Cloud is required to utilize these AI functionalities.

• AI Service Provider & Models: Groq Cloud high-speed inference engine using openai/gpt-oss-120b (Conversational Styling) and qwen/qwen3.6-27b (Hairstyle Vision Analysis).
• “Decode a Look” Hairstyle Vision Scanner: Uses Groq Vision models (qwen/qwen3.6-27b) to evaluate uploaded or captured haircut/styling photos. The AI automatically identifies the hairstyle name, crafts precise instructions to tell your barber/stylist, determines hair type compatibility, maintenance level, and recommends styling products in structured JSON.
• AI Beauty & Style Consultant Chatbot: Interactive conversational assistant powered by openai/gpt-oss-120b on Groq, providing tailored hair care routines, face-shape matching haircut guidance, beard grooming advice, and maintenance tips.

Security Note: All AI requests route securely through the Node.js backend. The GROQ_API_KEY is strictly managed via the backend .env file and is never exposed to client mobile devices.

Third-Party Integration Costs ($0 Upfront Setup)

FreshCut is designed to be highly cost-efficient. You can deploy and run the entire ecosystem at no upfront cost ($0) by leveraging the free developer tiers of the following integrated systems:

• MongoDB Atlas (Database): Free forever (The M0 Shared Tier is 100% free forever and includes 512MB storage — sufficient for thousands of users, salon listings, services, specialists, and bookings).
• Firebase Authentication & FCM (Auth & Push Alerts): Free forever (Firebase Spark plan provides unlimited user authentications, automated password reset emails, and native push notifications for iOS and Android for free).
• Cloudinary (Image Storage): Free forever (Free tier includes 25 monthly credits, equivalent to approx. 25,000 image transformations and HD salon portfolio storage slots).
• Groq Cloud API (AI Vision & LLM Chat): Free / Pay-as-you-go (Developer rate limits are free. Paid keys are fractional cents per 1M tokens with ultra-fast inference).
• Stripe SDK (Payments): Pay-as-you-go (No monthly fee. Stripe only charges a standard transaction rate of 2.9% + $0.30 per successful customer booking checkout).

Important Note – External Services and Configuration

This platform connects to external third-party services. For full functionality, configure your own credentials in the environment variables as documented in the included guide:

• Firebase Authentication & Admin SDK: Handles client signups, logins, automated password reset links, and server-side cryptographic ID token verification (firebase-admin/auth).
• Firebase Cloud Messaging (FCM) & Notifee: Dispatches real-time native push alerts for booking confirmations, appointment status updates, and administrative broadcasts.
• Payment Gateways (Stripe SDK): Handles in-app card checkout sessions via native Stripe Payment Sheets and secure webhook verification.
• Media Storage (Cloudinary SDK): Handles secure image uploads for salon cover photos, service thumbnails, transformation portfolio galleries, and user profile avatars.
• Database: Requires a MongoDB database instance (local MongoDB or MongoDB Atlas cloud).

Key Platform Features

• Multi-Tenant 3-App Architecture: Separate, tailored pure React Native CLI applications for Customers (@userapp), Salon Owners (@ownerapp), and Super Admins (@adminapp).
• Pure React Native CLI: Built directly with React Native CLI (v0.86.0) and NativeWind with New Architecture (Fabric/TurboModules) support.
• Nearby Salon Discovery: Geolocation distance calculation (km), city selector, price range, star rating filters, and search indexing.
• Multi-Category Services: Comprehensive categories including Haircuts, Beard Styling, Hair Coloring, Facials & Skincare, Massage & Spa, and Manicure/Pedicure.
• Concurrency Slot Locking: Atomic temporary slot locking with Time-To-Live (TTL) prevents double booking when multiple customers select the same specialist and time window simultaneously.
• “Decode a Look” AI Vision Scanner: Multimodal AI evaluates haircut images to generate barber instructions, hair type suitability, and product recommendations.
• AI Beauty & Style Consultant: Real-time conversational AI style assistant powered by Groq Cloud LLMs.
• Specialist Staff Selection: Choose individual salon barbers or beauty specialists with custom schedules, ratings, and bios.
• Stripe Payment Sheets & Cash Options: Secure in-app credit/debit card checkout or pay-at-salon options.
• Promotional Coupons & Banners: Platform discount codes with percentage/fixed deductions, usage limits, and expiry timers.
• Portfolio Gallery & Verified Reviews: Before-and-after client transformation showcases and authentic customer feedback ratings.
• Commission Engine & Payouts: Automated platform commission splitting with salon earnings tracking and withdrawal requests.
• Helpdesk & Support Ticketing: Dedicated support ticket system for customer and owner inquiries.

Included Modules & Codebase Analysis

1. Customer App (`userapp` – Client Booking Mobile Application)

• HomeScreen: Geolocation city selector, promotional banners carousel, popular categories, top-rated salon listings, and notifications badge.
• ExploreScreen: Interactive salon discovery with real-time text search, category filtering, distance radius slider, rating filters, and bottom sheet filter modal.
• ShopDetailsScreen: Salon overview, HD photo gallery, operating hours, active open/closed status, categorized service menu, specialist staff roster, and verified client reviews.
• BookingFlowScreen: Multi-step booking wizard: Service selection, specialist choice, date picker, dynamic time slots with atomic concurrency locking, coupon discount applicator, and payment method selector.
• BookingSuccessScreen: Booking receipt confirmation screen with direct appointment tracking shortcuts.
• UserBookingsScreen: Tabbed booking manager (Upcoming, Completed, Cancelled) with live status badges, detail modals, and post-service review submission forms.
• AIVisionScreen (“Decode a Look”): Camera & gallery upload interface to analyze hairstyles and extract barber instructions with Groq Vision.
• AIChatScreen: Conversational AI style & beauty consultation interface with message history.
• FavoritesScreen: Saved favorite salons list for quick re-booking.
• CouponsScreen: Active promo discount codes catalog with one-tap copy functionality.
• NotificationsScreen: Real-time push notification history and booking updates.
• Profile & EditProfileScreen: Manage user avatar, profile details, and account settings.
• ChangePassword & ForgotPasswordScreen: Secure password updates and Firebase automated recovery email dispatch.
• Auth Modules: Firebase email/password registration, login, and token synchronization.

2. Salon Owner App (`ownerapp` – Partner Management Application)

• HomeScreen (Owner Dashboard): Daily appointment counter, revenue summary, quick status toggles, and today’s schedule list.
• AppointmentsScreen: Calendar and list views of incoming bookings with status update controls (Confirm, Mark Completed, Cancel).
• ServicesScreen: Add, edit, categorize, and price salon services with custom duration and photo uploads.
• SpecialistsScreen: Manage staff specialists, assign serviceable specialties, upload avatars, and configure working shifts.
• PortfolioScreen: Upload and showcase transformation photos directly to the salon’s public gallery via Cloudinary.
• Wallet & RevenueScreen: Track gross earnings, platform commission deductions, net revenue, and submit withdrawal payout requests.
• ShopProfileScreen: Configure salon business name, description, address, location coordinates, contact numbers, and weekly operating hours.
• ReviewsScreen: View customer feedback and ratings left by verified clients.
• Auth & Profile Modules: Salon owner registration, login, profile editing, and password management.

3. Super Admin App (`adminapp` – Platform Governance Application)

• DashboardScreen: Real-time platform metrics: Total registered users, verified salon owners, active salons, total platform revenue, and booking volume.
• SalonApprovalScreen: Review submitted salon registration requests, inspect business details, and approve or reject listings.
• CitiesScreen: Add, edit, or toggle serviceable cities and geographic zones.
• CategoriesScreen: Manage global beauty and grooming categories with custom icons and names.
• BannersScreen: Create and publish home promotional banners linked to specific salon categories.
• CouponsScreen: Create discount coupons with percentage or fixed deductions, max usage limits, and expiry dates.
• PlatformSettingsScreen: Configure platform commission percentage (e.g. 10%), default currency symbol, and system flags without server restarts.
• SupportTicketsScreen: View, manage, and respond to user and salon owner support tickets.
• BroadcastScreen: Dispatch instant push notification alerts via Firebase FCM to all users or salon owners.
• Auth Modules: Super admin secure login, profile management, and password recovery.

4. Centralized Backend (Node.js & Express REST API)

• Auth Controller: Handles user registration, Firebase ID token verification (firebase-admin/auth), MongoDB profile synchronization, role-based authorization (RBAC), and session restoration (/api/auth/me).
• Shop Controller: Search, geolocation distance calculation, rating filters, operating hours checks, and shop details aggregation.
• Booking Controller: Handles atomic concurrency slot locking with TTL, appointment creation, commission calculation, status transitions, and review verification.
• AI Controller: Groq Cloud API wrappers for multimodal hairstyle vision analysis (qwen/qwen3.6-27b) and conversational styling advice (openai/gpt-oss-120b).
• Admin Controller: Salon approvals/rejections, platform financial analytics, commission fee adjustments, and city/category master management.
• Payment Controller: Stripe Payment Sheet session creation, webhook signature verification, and salon payout ledger processing.
• Banner & Coupon Controllers: Validation and redemption engine for promotional codes and home carousels.
• Upload Controller: Multi-part form image upload middleware routing to Cloudinary CDN storage.
• Notification Controller: Firebase Cloud Messaging (FCM) push notification dispatcher for booking alerts and admin broadcasts.

Project Requirements

• Node.js: v18.x or v20.x (LTS recommended)
• Database: MongoDB (Local Community Server v6/v7 or MongoDB Atlas Cloud)
• Android Build Standards: targetSdkVersion = 36, compileSdkVersion = 36, minSdkVersion = 24, JDK 17
• Mobile Framework: React Native CLI v0.86.0 (Android Studio SDK 34/35/36, Xcode 15/16 for iOS, CocoaPods)

Support & Contact

If you have any questions, require setup assistance, or need custom modifications, feel free to reach out:

• Email: shakeelsoftwaredev@gmail.com
• WhatsApp: +923136900591