Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/OswalSnow/AR-Barber/llms.txt

Use this file to discover all available pages before exploring further.

AR Barbería runs on a standard LAMP-style stack: PHP 8.4+, a relational database (MySQL or SQLite), and Node.js for the frontend build step. The steps below walk you from a fresh clone to a working local instance. The whole process takes under five minutes on a machine that already has PHP and Composer installed.
1

Clone the repository

Clone the AR Barbería source code and enter the project directory.
git clone https://github.com/OswalSnow/AR-Barber.git
cd AR-Barber
2

Install PHP and JS dependencies

Install Composer packages and Node modules. You can run the two commands in any order; both are needed before you continue.
composer install
The project ships a composer setup script that chains composer install, key generation, and migrations in one command. Run composer run setup if you prefer a single step after configuring .env.
3

Configure the environment

Copy the example environment file and update the values for your local setup.
cp .env.example .env
php artisan key:generate
Open .env in your editor and set at minimum:
.env
APP_NAME="AR Barbería"
APP_URL=http://localhost:8000

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ar_barberia
DB_USERNAME=root
DB_PASSWORD=
For a zero-config local setup, set DB_CONNECTION=sqlite and create an empty file at database/database.sqlite. Laravel will use it automatically without a running MySQL server.
4

Run database migrations

Create the database schema. Use --seed to populate the tables with sample barbers, services, and a staff user.
php artisan migrate --seed
Staff login requires a user with role='barber' in the users table. The --seed flag creates this user via the database seeders. Without it, the /login route will have no valid credentials to test with.
5

Build frontend assets and start the dev server

Compile Tailwind CSS and JavaScript bundles, then start the development server.
npm run build
php artisan serve
The composer run dev script uses concurrently to run php artisan serve, npm run dev (Vite HMR), and the queue worker in parallel — useful when actively developing.

​
Open the app

With the server running, open your browser and navigate to:
URLPurpose
http://localhost:8000Homepage — lists active barbers and opens the booking flow
http://localhost:8000/loginStaff login — use the credentials created by the seeder
The homepage shows every barber seeded into the database. Click a barber card to open their booking form and select a service, date, and time slot. Log in at /login to access the staff panel, where you can manage workdays, view appointments, and upload portfolio photos.

Introduction

Learn about the two user roles, key features, and the full tech stack.

Staff panel

Explore what authenticated barbers can do from the staff dashboard.

Build docs developers (and LLMs) love

Get started for freeTalk to us