Barbershop booking SystemApp

Job ID: 40142574

Budget: £750 – £1,500 GBP

Project Overview – Barbershop Booking & Management App

This project is inspired by Booksy (customer app) and Booksy Biz (business app), but the goal is to combine both into a single application with role-based access instead of two separate apps.

The platform serves three user roles:
• Customer
• Barber / Staff
• Owner

Each role sees different features and dashboards inside the same app.

I already have an APK build available that shows:
• The current UI/UX direction
• Existing screens and flows
• Features that are already partially implemented

The APK and screenshots are provided as a reference to speed up development, not to redesign everything from scratch. The expectation is to continue, improve, and complete what’s already started.



Core Features Required

1. Authentication & Roles
• Login / signup (email, phone, social-ready)
• Role-based access (Customer, Staff, Owner)
• Protected routes based on role



2. Customer Features (Booksy-style)
• Discover barbershops and barbers
• View barber profiles, services, prices, availability
• Book appointments (select barber, service, date, time)
• Join walk-in queue (virtual queue)
• View appointment history
• Freshness meter (days since last cut, rebook reminder)
• Receive notifications (reminders, queue updates, reviews)
• Leave reviews after appointments



3. Barber / Staff Features (Booksy Biz-style)
• Personal calendar and schedule management
• View and manage own appointments
• Walk-in queue management (start, skip, notify)
• Client list with visit history and notes
• Income tracking and performance stats
• Portfolio upload (photos of work)
• Participate in competitions and events



4. Owner Features
• Full barbershop management
• Manage staff, services, schedules, and working hours
• Financial overview (revenue, expenses, commissions)
• Analytics dashboard (appointments, revenue, performance)
• Set barber commissions (percentage / flat / tiered)
• Marketing campaigns (email/SMS/push)
• Event creation and management
• Hiring system (job posts and applications)



5. Booking & Walk-In System
• Appointment statuses: scheduled, in progress, finished, cancelled, no-show
• Real-time walk-in queue with estimated wait time
• Live updates using realtime subscriptions
• Notifications when turn is approaching



6. Social & Community Features
• Barber portfolios (photos, likes)
• Posts, comments, and engagement
• Competitions (Battle Arena):
• Entry submissions
• Voting
• Leaderboards
• Events (RSVP, attendee list)



7. AI & Smart Features
• Virtual hairstyle try-on (photo upload + canvas)
• Smart barber matching (recommendations)
• Freshness meter (gamified rebooking)
• AI-based admin selection for competition regions



Tech Stack (Must Be Used)
• Frontend: React + TypeScript + Vite
• UI: Tailwind CSS + shadcn/ui
• State/Data: TanStack React Query, React Hook Form + Zod
• Backend: Supabase (PostgreSQL, Auth, Realtime, Storage)
• Server Logic: Supabase Edge Functions
• Mobile: Capacitor (Android & iOS)
• Notifications: Push, email, SMS
• Security: Strong Row Level Security (RLS)



Expectations
• Build on top of the existing APK
• Clean, scalable, production-ready code
• Mobile-first, smooth UX similar to Booksy
• Secure data access using Supabase RLS
• Real-time updates where required
• Clear communication on what’s done vs what’s remaining