Skip to main content

Quick Start Guide

Get up and running with Salonnz in just a few minutes! This guide assumes you've already completed the installation.

1. Access the Admin Panel

After starting the admin panel server:

cd Frontend-Admin-Panel
npm run dev

Navigate to http://localhost:3000 and log in with a sample account from the master database.

2. Configure Your Salon

Business Settings

  1. Go to Settings → Business Settings
  2. Configure:
    • Business name and contact details
    • Operating hours
    • Time zone
    • Tax settings

Add Locations

  1. Navigate to Settings → Locations
  2. Click Add Location
  3. Enter location details:
    • Name, address, phone
    • Operating hours
    • Coordinates (for map)

Add Services

  1. Go to Services → Service List
  2. Click Add Service
  3. Configure:
    • Service name and description
    • Duration and price
    • Category
    • Payment type (Pay at Salon, Deposit, Save Card, Pay Later)

Add Staff

  1. Navigate to Staff → Staff List
  2. Click Add Staff Member
  3. Enter staff details:
    • Name, email, phone
    • Services they can perform
    • Working hours
    • Commission rate

3. Configure Booking Settings

  1. Go to Settings → Front-End Booking
  2. Enable/disable features:
    • Guest Checkout: Allow bookings without registration
    • Staff Selection: Let customers choose staff
    • Enable Signup: Allow new user registration
    • Booking Interval: Time slot intervals (5-240 minutes)
    • Deposit Enable: Require deposits for certain services
    • Cancellation Policy: Show policy checkbox

4. Set Up Stripe Payments

  1. Go to Settings → Payment Settings
  2. Enter your Stripe credentials:
    • Publishable Key
    • Secret Key
  3. Configure payment options:
    • Enable deposit payments
    • Enable save card
    • Enable pay later

5. Test User Booking Flow

Web App

cd Frontend-Userapp-Web
npm run dev

Visit http://localhost:3001/[salon-slug] (e.g., http://localhost:3001/harry-spa)

Mobile App

cd Frontend-User-App-React-Native
npx expo start

Scan QR code with Expo Go app.

Complete a Test Booking

  1. Select Location (if multiple locations)
  2. Choose Service - Browse and select services
  3. Select Date & Time - Pick available time slot
  4. Choose Staff (if enabled)
  5. Login/Guest - Sign in or continue as guest
  6. Review & Confirm - Check details
  7. Payment - Complete payment (use Stripe test card: 4242 4242 4242 4242)
  8. Confirmation - View booking confirmation

6. Test API with Postman

  1. Import Salonnz-api-collection.json into Postman
  2. Test authentication endpoints
  3. Explore booking, payment, and customer endpoints

Common Test Credentials

Salon Tenants

From the master database (client_database):

  • harry-spa (client_82637)
    • Email: harry@yopmail.com
    • Database: client_82637

Stripe Test Cards

  • Success: 4242 4242 4242 4242
  • Requires Authentication: 4000 0025 0000 3155
  • Declined: 4000 0000 0000 9995

Expiry: Any future date
CVC: Any 3 digits

Next Steps

Now that you have a working setup:

Need Help?