LUNA Beauty Suite | Management System (Python Flask Windows App)

LUNA Beauty Suite | Salon Management

LUNA Beauty Suite is a complete, ready-to-deploy beauty salon and spa management system built with Python Flask and SQLite. It combines a modern Point of Sale (POS) interface, an appointment scheduler, a full client relationship management (CRM) module with loyalty points, employee management, retail inventory tracking, a multi-currency pricing system, and a powerful analytics dashboard.

Designed for small and medium beauty businesses, hairdressers, nail salons, spas and barbershops, the application runs out of the box with zero configuration, automatically creating its database and demo data on the first launch.

⭐ Key Features

Point of Sale (POS)

• Touch-friendly checkout that quickly combines services and products in a single cart
• Assign a client and an employee to every sale
• Accept Cash, Card or Mobile payments
• Sales recorded instantly
• Product stock decremented automatically
• Loyalty points awarded to clients

Appointment Scheduler

• Book, confirm, complete or cancel appointments
• Completing an appointment automatically generates the matching sale record
• Updates revenue, loyalty points and client visit count

Client CRM

• Full customer profiles with auto-generated client codes
• Loyalty points tracking
• Total visits counter
• Allergies and notes fields

‍♀️ Employee Management

• Manage staff with roles and availability status (available, busy, offline)
• Employees tracked per appointment and per sale

Inventory Management

• Retail products with stock tracking
• Low-stock threshold alerts highlighted on the dashboard and POS

Analytics Dashboard

• Today’s revenue vs yesterday
• 7-day revenue chart with day selector
• Top clients, top services and products
• Low-stock warnings and pending appointments

Multi-Currency Support

• Eight pre-configured world currencies (EUR, USD, GBP, CHF, CAD, BRL, MAD, XOF)
• Optional live international exchange rates via a free API (no key required)
• Prices refresh automatically every 15 minutes
• Currency preference remembered via localStorage

Appointment Notifications

• Global bell polls every 30 seconds
• Alerts staff when a client is due within two hours
• Built-in sound alert
• One-click WhatsApp client reminder (wa.me)

Sales History

• Full searchable log of every POS sale and completed appointment
• Filtering by date range, client code and employee
• CSV export included

Role-Based Access

• Administrator and Cashier roles
• Restricted navigation for cashiers (redirected automatically to the POS)

Security

• CSRF protection
• Input sanitization to prevent XSS attacks
• Secure HTTP-only and SameSite cookies
• Anti-clickjacking headers
• Password hashing

Zero-Configuration Setup

• SQLite database with auto-seeded demo data (admin user, staff, clients, services and products)
• Plug-and-play install with included Windows .bat scripts
• Gunicorn, Waitress, Docker and cPanel (Passenger) deployment guides included

Demo Credentials

Administrator

️ Username: admin | Password: admin123 (full access)

Cashier

️ Username: caissier | Password: caissier123 (POS only)

⚙️ Requirements & Installation

Prerequisites

• Python 3.9 or higher (recommended: 3.11 / 3.12 / 3.14)
• pip (Python Package Installer)
• Any modern web browser (Chrome, Firefox, Edge, Safari)

Quick Setup (Windows)

1. Extract the ZIP archive to any folder
2. Run the setup script runnewpc.bat (installs all dependencies automatically)
3. Start the application with start.bat
4. Open http://localhost:5000 in your browser

Manual Setup (Cross-Platform)

1. Extract the ZIP archive to any folder
2. Open a terminal in the project folder
3. Run: pip install -r requirements.txt
4. Run: python app.py
5. Open http://localhost:5000 in your browser

The database and demo data are created automatically on first run. No extra configuration required.

️ Tech Stack

python | flask | flask-wtf | flask-sqlalchemy | werkzeug | sqlite | tailwind css | chart.js | vanilla javascript | jinja2 | bleach | gunicorn | waitress | point of sale | appointment scheduler | client management | inventory | multi-currency | exchange rates | dashboard | sales report | loyalty points | whatsapp reminders | crm | beauty salon | spa | cpanel | passenger | docker

What’s Included

• Full source code
• Complete documentation folder
• ️ Requirements file (requirements.txt)
• Demo database with sample data (admin, staff, clients, services, products)
• Responsive design (desktop, tablet, and mobile)
• WhatsApp integration for client reminders
• Multi-currency system with live exchange rates (free API)
• Windows .bat launchers + deployment guides (Gunicorn, Waitress, Docker, cPanel)

Why Choose LUNA Beauty Suite?

LUNA Beauty Suite is a premium, production-ready solution for beauty salons, hairdressers, nail salons, spas, barbershops and wellness studios that need a fast, secure and easy-to-use management system. With zero-configuration setup, a modern glassmorphism interface, automatic live currency rates, and built-in appointment notifications with WhatsApp reminders, it provides everything you need to run your beauty business efficiently.