Peak Barbers

Peak Barbers is an open-source FiveM barbershop resource with native chair seating, animated barber NPCs, live appearance previews, peak-bridge integration, and a React + TypeScript NUI.

Source: github.com/Peak-Studios/peak-barbers

• Hair, beard, eyebrow, eye-color, and makeup customization
• Save on payment and appearance rollback on cancel
• ESX, QBCore, and Qbox support through peak-bridge
• ox_target, qb-target, qtarget, and marker interaction modes
• English, French, Spanish, and Arabic locales
• Server-authoritative chair validation and rate-limited callbacks
• Built React/Vite NUI included for drag-and-drop installation

Place the resource at:

text
resources/[peak]/peak-barbers

Install and configure:

• One framework: es_extended, qb-core, or qbx_core
• peak-bridge
• A supported appearance resource configured in peak-bridge
• An optional target resource, unless using marker interaction

Start dependencies before Peak Barbers. For example:

cfg
ensure es_extended
ensure illenium-appearance
ensure ox_target
ensure peak-bridge
ensure peak-barbers

Use your own framework, appearance, and target resource names where they differ.

Edit shared/config.lua.

Framework, money, notification, callback, and appearance providers are configured in peak-bridge.

Most chairs use a vector4 containing position and heading:

lua
chairs = {
    vector4(0.0, 0.0, 0.0, 0.0),
}

For custom interiors, a chair can instead define target, stand, exit, and optional camera or barber positions. Enable Config.Debug while tuning placement.

The server accepts only configured chair IDs. A player can reserve one chair at a time and must be within 5 meters when starting a session.

When a player confirms, the server validates the active chair session and payment through peak-bridge, then the client saves the appearance. Canceling reloads the previous appearance and releases the chair.

The NUI source is React + TypeScript in ui/:

powershell
cd ui
npm install
npm run lint
npm run build

The manifest loads ui/dist/index.html. Keep ui/dist in releases and exclude ui/node_modules.

For the complete source-pinned reference, connect to the Peak Studios MCP server or read the repository's installation guide and documentation.