This guide walks you through setting up Avalúo Vehicular on your local machine without Docker. You will configure a full Laravel 12 + React 19 development environment — including the PHP backend, Vite-powered frontend, SQLite database, and queue worker — all running concurrently via a singleDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/alber1802/AvaluoVehicular/llms.txt
Use this file to discover all available pages before exploring further.
composer dev command. This approach is best for active feature development, where you want fast hot-module replacement and direct access to logs and the file system.
Prerequisites
Before you begin, make sure the following tools are installed and available on
your
PATH:- PHP 8.2 or higher — required by
composer.json("php": "^8.2") - Composer — PHP dependency manager
- Node.js 20 or higher — required to run Vite 7 and build React assets
- SQLite — the default database driver (
DB_CONNECTION=sqlite)
Installation
Install PHP Dependencies
Install all Laravel backend packages defined in
composer.json, including Laravel 12, Fortify, Inertia.js, Spatie Permissions, and PDF generation libraries:Install Node.js Dependencies
Install frontend packages defined in
package.json, including React 19, TypeScript, TailwindCSS 4, Radix UI components, Vite 7, and ESLint/Prettier tooling:Copy Environment File
Create your local environment configuration from the provided example:Open
.env and review the defaults. The most relevant settings for local development are:Generate Application Key
Generate a unique
APP_KEY used by Laravel to encrypt cookies, sessions, and other sensitive data:Create the SQLite Database
Laravel’s SQLite driver requires the database file to exist before running migrations:
Run Database Migrations
Apply all migrations to create the application schema — vehicle records, appraisal evaluations, user management, roles, and permissions:
Start the Development Servers
Launch all development processes in a single terminal using the The application will be available at http://localhost:8000 once all three processes have started.
composer dev script. This runs three concurrent processes managed by concurrently:php artisan serve— PHP development server onhttp://localhost:8000php artisan queue:listen --tries=1— Queue worker for background jobsnpm run dev— Vite dev server with hot-module replacement
Development Commands
Use these commands during day-to-day development:| Command | Description |
|---|---|
composer dev | Start PHP server, queue worker, and Vite concurrently |
npm run dev | Start only the Vite frontend dev server |
npm run build | Build frontend assets for production |
npm run lint | Run ESLint with auto-fix (eslint . --fix) |
npm run format | Format all files in resources/ with Prettier |
npm run types | Run TypeScript type-checking without emitting files |
php artisan test | Run the PHPUnit test suite (clears config cache first) |
Cache Management
Clear All Caches
When switching branches, pulling changes, or debugging unexpected behavior, clear all framework caches at once:Rebuild Caches for Production-like Testing
After clearing, you can pre-compile configuration and routing for faster response times:Do not commit cached files to version control. Running
php artisan optimize:clear before switching branches is a good habit to avoid stale cache
conflicts.Fix Storage Permissions
On Linux and Mac, Laravel requires write access to thestorage and bootstrap/cache directories. If you see Permission denied errors, reset the permissions:
php artisan serve, the web server user (commonly www-data) also needs write access: