Salon Booking App - StyleX 💈✨

A complete salon booking mobile application built with Flutter and Django REST Framework. this project feature an AI-powered chatbot, ML-based hairstyle recommendations and real-time booking managment system for both users and salon admins.

📱 Overview

StyleX is modern salon booking platform that connects customers with salons in their area. The app makes it easy for users to browse salons, book appointments, get AI-powered style suggestions and manage they're bookings all in one place. For salon owners, it provides a powerful admin panel to manage services staff and track revenue.

✨ Key Features

For Users 👤

• Browse Salons: Discover salons near you with location-based search and filtering
• Smart Booking System: Book appointments with preferred stylists at convienient times
• AI Chatbot Assistant: Get instant answers and recommendations through intelligent chat
• ML Hairstyle Suggestions: Upload your photo and get personalized hairstyle recommedations using machine learning
• Reviews & Ratings: Read reviews and rate your experience after each visit
• Real-time Notifications: Receive instant updates about booking status via Firebase Cloud Messaging
• Payment Integration: Secure in-app payment processing for bookings
• Profile Management: Manage your preferences bookings history and favorite salons

For Salon Admins 🏪

• Dashboard Analytics: View comprehensive insights on revenue bookings and performance
• Service Management: Add update and remove services with pricing and duration
• Staff Management: Manage stylist profiles schedules and availability
• Booking Management: View approve and manage all customer bookings
• Revenue Tracking: Monitor daily weekly and monthly revenue with visual charts
• Customer Insights: Access customer data reviews and booking patterns
• AI Chatbot for Admins: Special admin chatbot for business analytics and staff management

🛠️ Tech Stack

Mobile App (Frontend)

• Flutter - Cross-platform mobile framework
• GetX - State management routing and dependency injection
• Firebase:
  • Firebase Auth - User authentication
  • Firebase Messaging - Push notifications
• http - API integration
• fl_chart - Beautiful charts for analytics
• image_picker - Camera and gallery access
• geolocator - Location services
• GlassMotion Navbar - Modern glassmorphic navigation

Backend (API)

• Django 4.x - Web framework
• Django REST Framework - RESTful API
• SQLite - Database (easily switchable to PostgreSQL)
• Firebase Admin SDK - Push notifications and auth verification
• Python ML Libraries - For hairstyle analysis features
• Gemini AI Integration - Powers the intelligent chatbot

📂 Project Structure

SALOON APP/
│
├── salon_booking/              # Flutter Mobile Application
│   ├── lib/
│   │   ├── controllers/        # GetX Controllers (State Management)
│   │   ├── models/             # Data models
│   │   ├── views/              # UI Screens
│   │   │   ├── admin/          # Admin dashboard screens
│   │   │   └── user/           # User-facing screens
│   │   ├── widgets/            # Reusable UI components
│   │   ├── services/           # API services
│   │   ├── routes/             # App navigation
│   │   └── theme/              # App theming
│   ├── android/                # Android-specific files
│   ├── ios/                    # iOS-specific files
│   └── pubspec.yaml            # Flutter dependencies
│
└── backend/                    # Django REST API
    ├── accounts/               # User authentication & profiles
    ├── bookings/               # Booking management
    ├── salons/                 # Salon information
    ├── services/               # Salon services
    ├── staff/                  # Staff/stylist management
    ├── reviews/                # Reviews and ratings
    ├── chatbot/                # AI chatbot logic
    ├── hairstyle_ml/           # ML hairstyle analyzer
    ├── firebase/               # Firebase integration
    ├── api/                    # API endpoints
    └── backend/                # Django settings

🚀 Getting Started

Prerequisites

Before you begin make sure you have these installed:

• Flutter SDK (3.9.2 or higher)
• Dart SDK
• Python 3.8+
• pip (Python package manager)
• Android Studio or Xcode (for mobile development)
• Firebase project setup

Backend Setup

1. Navigate to backend directory:

cd backend

2. Create and activate virtual enviroment:

python -m venv venv
venv\Scripts\activate  # On Windows
source venv/bin/activate  # On macOS/Linux

3. Install dependencies:

pip install -r requirements.txt

4. Setup environment variables: Create a .env file in backend/ with:

FIREBASE_CREDENTIALS_PATH=path/to/serviceAccountKey.json
GEMINI_API_KEY=your_gemini_api_key
SECRET_KEY=your_django_secret_key

5. Run migrations:

python manage.py makemigrations
python manage.py migrate

6. Create superuser (admin):

python manage.py createsuperuser

7. Start development server:

python manage.py runserver

The API should now be running at http://localhost:8000

Mobile App Setup

1. Navigate to Flutter directory:

cd salon_booking

2. Install dependencies:

flutter pub get

3. Setup Firebase:

• Add google-services.json to android/app/ (for Android)
• Add GoogleService-Info.plist to ios/Runner/ (for iOS)
• Update lib/firebase_options.dart with your Firebase config

4. Update API endpoint: In your services files update the base URL to point to your backend server

5. Run the app:

flutter clean
flutter pub get
flutter run

🔧 Configuration

Firebase Setup

1. Create a Firebase project at https://console.firebase.google.com
2. Enable authentication (Email/Password)
3. Enable Cloud Messaging
4. Download configuration files for both Android and iOS
5. Update backend with Firebase Admin SDK credentials

API Configuration

Update the base URL in Flutter app's service files:

static const String baseUrl = 'http://YOUR_IP:8000/api';

📸 Features in Detail

AI Chatbot

The chatbot uses Google's Gemini AI to provide intelligent responses. Users can ask questions about:

• Salon services and pricing
• Booking availability
• Style recommendations
• General salon information

Admins get additional chatbot features for:

• Business analytics queries
• Staff performance insights
• Revenue analysis

ML Hairstyle Analyzer

Upload a photo and our ML model analyzes:

• Face shape detection
• Skin tone analysis
• Personalized hairstyle suggestions
• Style compatibility scores

Real-time Notifications

Firebase Cloud Messaging provides instant updates for:

• Booking confirmations
• Appointment reminders
• Status changes
• Special offers

🎨 Design Features

The app uses modern UI/UX principles including:

• Glassmorphism effects
• Smooth animations and transitions
• Dark mode support
• Responsive layouts
• Custom themed components

🧪 Testing

Backend Tests

cd backend
python manage.py test

Flutter Tests

cd salon_booking
flutter test

📱 Building for Production

Android APK

flutter build apk --release

Android App Bundle

flutter build appbundle --release

iOS

Majorly not focused on the IOS

flutter build ios --release

🔐 Security Features

• JWT-based authentication
• Firebase Auth integration
• Secure API endpoints
• Input validation and sanitization
• HTTPS ready

🤝 Contributing

Contributions are welcomed! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

Mithil Dabhi and Mann Dangrechiya😁

👨💻 Developers

Built with passion by Mithil Dabhi and Mann Dangrechiya

📧 Contact

For questions or support, please reach out through:

• Email: mithildabhi@gmail.com
• Email: manndangrechiya@gmail.com
• GitHub Issues: Project Issues

🙏 Acknowledgments

• Flutter team for the amazing framework
• Django REST Framework community
• Firebase for backend services
• Google Gemini AI team
• All open-source contributors whos libraries made this possible

---

Note: This project was built as a comprehensive solution for salon managment and customer booking. Feel free to customize it for your specific needs!

🐛 Known Issues

• Payment gateway integration is in beta
• iOS push notifications may require additional setup
• ML model accuracy improves with more training data

🗺️ Roadmap

• Multi-language support
• Advanced analytics dashboard
• Loyalty program integration
• Social media sharing
• Video consultations
• Advanced calendar managment
• Integration with popular payment gateways
• Web admin panel

⚡ Performance

The app is optimized for:

• Fast loading times
• Smooth animations (60 FPS)
• Efficient state managment
• Minimal battery consumption
• Low memory footprint

📊 API Endpoints

Some key API endpoints include:

Authentication

• POST /api/auth/register/ - User registration
• POST /api/auth/login/ - User login
• POST /api/auth/logout/ - User logout

Bookings

• GET /api/bookings/ - List bookings
• POST /api/bookings/create/ - Create booking
• PUT /api/bookings/{id}/ - Update booking

Salons

• GET /api/salons/ - List salons
• GET /api/salons/{id}/ - Salon details

Chatbot

• POST /api/chatbot/user/ - User chatbot
• POST /api/chatbot/admin/ - Admin chatbot

ML Features

• POST /api/hairstyle/analyze/ - Analyze photo for hairstyle

For complete API documentation, visit /api/docs/ when server is running.

---

Made with ❤️ using Flutter and Django