FreshCut | AI-Powered Salon Booking React Native App

FreshCut is an innovative, AI-powered multi-application platform built for modern salon appointment booking, business management, and platform administration. This complete solution provides a centralized Node.js backend and three beautifully designed, highly functional React Native mobile applications tailored for customers, salon owners, and platform administrators.

The code is clean, scalable, and well-structured, utilizing a modular architecture with reusable components. Built with the latest React Native (Expo) and TypeScript, it ensures a smooth and engaging user experience across both Android and iOS devices. The styling is handled with NativeWind (TailwindCSS) for a pixel-perfect modern interface.

Demo APKs (Download & Test)

• User App (Customer): Download User App APK
• Owner App (Salon Manager): Download Owner App APK
• Admin App (Super Admin): Download Admin App APK

Important Note - External Services and API Keys

Warning: This platform includes features that rely on third-party external services. For the following features to function properly, you will need to provide your own API keys and may incur additional costs depending on the service provider's pricing plan:

• Authentication: Powered by Google Firebase Authentication. Requires setting up a Firebase project and configuring the Admin SDK keys on the backend and client-side web API keys on the mobile apps.
• AI Features: Requires a Google Gemini AI or Groq API Key to power the smart AI chat and AI vision functionalities within the User App.
• Payments: Requires a Stripe Account for secure in-app payment processing.
• Cloud Storage: Requires Cloudinary for fast image hosting and file uploads.
• Database: Requires a MongoDB instance (local or MongoDB Atlas).
• Notifications: Uses Firebase Cloud Messaging (FCM) in combination with the Expo Push Notifications service for robust, native cross-platform delivery to Android and iOS.

Key Platform Features

• Google Firebase Authentication for robust, secure, and modern sign-in operations.
• Integrated AI Assistant powered by Google Gemini or Groq (Chat & Vision).
• Supported natively on Android and iOS (via Expo).
• Built with React Native, latest Expo SDK, and TypeScript.
• Robust Node.js, Express, and MongoDB RESTful Backend.
• Dynamic Multi-Currency Support configurable directly from the Admin App.
• Modern UI/UX Design using NativeWind (Tailwind CSS) and Gorhom Bottom Sheets.
• Real-time Updates via Socket.io (Instant booking status changes).
• Automated native push notifications delivered directly via Firebase Cloud Messaging (FCM).
• Secure In-App Payments with Stripe React Native Integration.
• Clean and Professional Layout with Smooth Animations.
• Redux Toolkit for scalable state management.

Included Modules & Application Features

1. User App (Customer Application)

• Smart AI Assistant: Includes an intelligent AI Chat to help customers discover styles, and an AI Vision tool to analyze uploaded photos and suggest matching salon services.
• Authentication: Secure sign-up, sign-in, and verification driven by Google Firebase Auth.
• Discovery: Browse nearby salons, view rich portfolios, and discover services.
• Booking Flow: Select services, choose specific staff members, and pick available calendar time slots.
• Payments: Secure checkout process via Stripe.
• Booking Management: View upcoming and past appointments, with options to manage them.
• Notifications: Real-time in-app alerts and native push notifications (FCM) for booking confirmations, cancellations, and reminders.

2. Owner App (Salon Management Dashboard)

• Shop Management: Edit shop details, business hours, and portfolio images dynamically.
• Booking Oversight: Accept, decline, or mark customer appointments as completed in real-time.
• Staff Management: Add employees, assign working hours, and track individual schedules.
• Service Menu: Add, edit, or remove salon services and update pricing.
• Financials: Monitor revenue, track earnings, and manage platform fee payouts.
• Notifications: Receive instant push notifications (FCM) on new bookings, cancellations, and payment payouts.

3. Admin App (Platform Control Center)

• Global Dashboard: View platform-wide metrics, active users, and total registered shops.
• Onboarding Moderation: Review and approve or reject new salon applications to maintain quality.
• User & Shop Management: Oversee platform activity and maintain integrity.
• Dispute & Ticket Resolution: Manage support tickets and user/owner interactions.
• Platform Settings & Multi-Currency: Configure global settings, stripe keys, commission rates, and select the platform's primary currency (defining both currency symbols like $, €, £ and standard currency codes like usd, eur, gbp).

4. Centralized Backend (Node.js API)

• RESTful Architecture: Secure, rate-limited endpoints for all mobile applications.
• Database: Strict Mongoose schemas and optimized queries for fast data retrieval.
• Security: Secure Google Firebase Auth token verification, Bcrypt password hashing, Helmet, and CORS protection.
• Real-time Sockets: Live bi-directional updates for booking statuses using Socket.io.
• FCM Push Notifications: Server integrates standard push logs to the MongoDB database, emits socket events to online users, and routes push packets via Firebase Cloud Messaging.
• Background Jobs: Automated scheduled tasks using Node-cron.

Project Requirements

• 
     
• Node.js (v18 or higher)   
• MongoDB Instance (Local or Cloud)   
• Latest Expo CLI   
• Basic React Native and Node.js knowledge for deployment and customization   
• Android Studio or VS Code for development