Technology Stack - VIP2CARS

Overview

VIP2CARS is built with modern PHP and JavaScript technologies, leveraging the latest versions of Laravel and its ecosystem.

Backend Stack

Core Framework

Laravel 12

Version: 12.0
License: MIT
Package: laravel/frameworkLaravel 12 is the latest major version of the PHP framework, providing:

Modern PHP 8.2+ features
Eloquent ORM for database management
Blade templating engine
Built-in authentication scaffolding
Artisan CLI for development tasks
Database migrations and seeding
Middleware pipeline
Service container and dependency injection

PHP Requirements

PHP

^8.2

required

Minimum PHP version 8.2 required for modern language features including:

Readonly classes
Disjunctive Normal Form (DNF) types
Constants in traits
Deprecation of dynamic properties

Authentication & Security

Laravel Fortify 1.30

Package: laravel/fortify
Purpose: Backend authentication implementationFortify provides the backend authentication logic including:

User registration
Login/logout
Password reset
Email verification
Two-factor authentication (2FA)
Profile management

Configuration: /app/Providers/FortifyServiceProvider.php

Development Tools

Laravel Tinker 2.10

Package: laravel/tinkerPowerful REPL (Read-Eval-Print Loop) for:

Interactive debugging
Testing Eloquent queries
Running code snippets
Database inspection

Frontend Stack

UI Framework

Livewire 4.0

Package: livewire/livewire
Version: 4.0Full-stack framework for building dynamic interfaces:

Reactive components without JavaScript
Real-time validation
Server-side rendering
Wire directives for interactivity
Event dispatching and listening
File uploads
Component lifecycle hooks

Additional Livewire Packages:

livewire/blaze (1.0) - Performance optimization
livewire/flux (2.9.0) - UI component library

Component Library

Flux UI 2.9

Package: livewire/flux
Version: 2.9.0Official Livewire UI component library providing:

Pre-built, accessible components
Consistent design system
Form elements
Navigation components
Icons and graphics
Modal dialogs
Notifications

Custom Components Location: /resources/views/flux/

CSS Framework

Tailwind CSS 4.0

Package: tailwindcss
Version: 4.0.7Utility-first CSS framework:

Rapid UI development
Just-in-time (JIT) compilation
Custom design system
Responsive design utilities
Dark mode support
Component extraction

Vite Integration: @tailwindcss/vite (4.1.11)Additional Tools:

autoprefixer (10.4.20) - CSS vendor prefixing
@tailwindcss/oxide-linux-x64-gnu (4.0.1) - Optimized Rust engine

Build Tools

Vite 7.0

Package: vite
Version: 7.0.4Next-generation frontend tooling:

Lightning-fast HMR (Hot Module Replacement)
Optimized production builds
ESM-based development server
Plugin ecosystem

Laravel Integration: laravel-vite-plugin (2.0)Configuration: vite.config.js

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/css/app.css', 'resources/js/app.js'],
            refresh: true,
        }),
    ],
});

JavaScript Libraries

Axios

1.7.4

Promise-based HTTP client for browser requests

API communication
Request/response interceptors
Automatic JSON transformation

Testing Stack

Testing Framework

Pest PHP 3.8

Package: pestphp/pest
Version: 3.8Modern PHP testing framework:

Elegant syntax
Parallel test execution
Code coverage reporting
Snapshot testing
Time manipulation

Laravel Integration: pestphp/pest-plugin-laravel (3.2)Example Test:

it('creates a cliente successfully', function () {
    $response = $this->post('/clientes', [
        'nombres' => 'John',
        'apellidos' => 'Doe',
        'nro_documento' => '12345678',
        'correo' => 'john@example.com',
        'telefono' => '123456789'
    ]);
    
    $response->assertRedirect('/clientes');
    $this->assertDatabaseHas('clientes', ['correo' => 'john@example.com']);
});

Mock & Assertions

Mockery

1.6

PHP mock object framework for unit testing

Faker

1.23

Generate fake data for testing and seeding

fakerphp/faker

Code Quality Tools

Linting & Formatting

Laravel Pint 1.24

Package: laravel/pintOpinionated PHP code style fixer:

Based on PHP-CS-Fixer
Zero configuration required
Laravel coding standards
Parallel processing

Configuration: pint.jsonCommands:

composer run lint        # Fix code style
composer run lint:check  # Check without fixing

Error Handling

Collision

8.6

Package: nunomaduro/collisionBeautiful error reporting for console:

Detailed stack traces
Code snippets
Syntax highlighting
Test failure formatting

Development Tools

Local Development

Laravel Sail 1.41

Package: laravel/sailDocker-based development environment:

Pre-configured Docker containers
MySQL, PostgreSQL, Redis support
Mailpit for email testing
Node.js and NPM included

Commands:

./vendor/bin/sail up    # Start containers
./vendor/bin/sail down  # Stop containers

Laravel Pail 1.2

Package: laravel/pailReal-time log monitoring:

Tail application logs
Filter by level and channel
Beautiful console output
JSON log parsing

Usage:

php artisan pail

Performance

Laravel Boost

2.0

Package: laravel/boostPerformance optimization for Laravel applications

Automatic optimizations
Command: php artisan boost:update

Process Management

Concurrently

9.0.1

Run multiple commands concurrentlyUsage in package.json:

"dev": "concurrently \"php artisan serve\" \"npm run dev\""

Database

Supported Databases

Laravel 12 supports multiple database systems:

MySQL (5.7+)
PostgreSQL (11+)
SQLite (3.35+)
SQL Server (2017+)
MariaDB (10.3+)

VIP2CARS can be configured to use any of these databases via the .env file.

Migration System

Laravel’s migration system provides:

Version control for database schema
Rollback capability
Database seeding
Schema builder with fluent API

Production Optimizations

Rollup (Build)

@rollup/rollup-linux-x64-gnu

4.9.5

Optimized JavaScript bundler for production builds

Native Linux binary for faster builds
Tree-shaking for smaller bundles

CSS Optimization

lightningcss-linux-x64-gnu

1.29.1

Extremely fast CSS parser and transformer

Native Rust implementation
CSS minification
Vendor prefixing

Composer Scripts

Automated development workflows:

{
  "setup": "Install dependencies and setup environment",
  "dev": "Start development servers (app, queue, vite)",
  "lint": "Fix code style issues",
  "lint:check": "Check code style without fixing",
  "test": "Run test suite with linting",
  "ci:check": "Run CI checks"
}

Development Server

composer run dev

Starts three concurrent processes:

PHP Server - php artisan serve
Queue Worker - php artisan queue:listen
Vite Dev Server - npm run dev

The dev script uses concurrently with color-coded output for each service.

NPM Scripts

{
  "dev": "vite",
  "build": "vite build"
}

Development: Real-time compilation with HMR
Production: Optimized, minified assets

Version Summary

Core Dependencies

Package	Version	Purpose
Laravel Framework	^12.0	Core framework
PHP	^8.2	Language runtime
Livewire	^4.0	Full-stack framework
Flux UI	^2.9.0	Component library
Laravel Fortify	^1.30	Authentication
Tailwind CSS	^4.0	CSS framework
Vite	^7.0	Build tool
Pest PHP	^3.8	Testing framework

Development Dependencies

Package	Version	Purpose
Laravel Pint	^1.24	Code formatter
Laravel Sail	^1.41	Docker environment
Laravel Pail	^1.2	Log monitoring
Faker	^1.23	Test data generation
Mockery	^1.6	Mocking framework

System Requirements

Server Requirements

PHP: 8.2 or higher
Composer: 2.x
Node.js: 18.x or higher
NPM: 9.x or higher
Database: MySQL 5.7+, PostgreSQL 11+, or SQLite 3.35+
Extensions:
- BCMath
- Ctype
- Fileinfo
- JSON
- Mbstring
- OpenSSL
- PDO
- Tokenizer
- XML

Development Environment

Git: Version control
Docker (optional): For Laravel Sail
Redis (optional): For caching and queues
Mailpit (optional): For email testing

License

All packages are open-source with MIT license, ensuring:

Free commercial use
Modification rights
Distribution rights
Private use

The entire VIP2CARS stack is built on MIT-licensed software, making it freely usable for commercial projects.

Architecture

Models & Controllers

Extension

​Overview

​Backend Stack

​Core Framework

​PHP Requirements

​Authentication & Security

​Development Tools

​Frontend Stack

​UI Framework

​Component Library

​CSS Framework

​Build Tools

​JavaScript Libraries

​Testing Stack

​Testing Framework

​Mock & Assertions

​Code Quality Tools

​Linting & Formatting

​Error Handling

​Development Tools

​Local Development

​Performance

​Process Management

​Database

​Supported Databases

​Migration System

​Production Optimizations

​Rollup (Build)

​CSS Optimization

​Composer Scripts

​Development Server

​NPM Scripts

​Version Summary

​Core Dependencies

​Development Dependencies

​System Requirements

​License

Build docs developers (and LLMs) love

Overview

Backend Stack

Core Framework

PHP Requirements

Authentication & Security

Development Tools

Frontend Stack

UI Framework

Component Library

CSS Framework

Build Tools

JavaScript Libraries

Testing Stack

Testing Framework

Mock & Assertions

Code Quality Tools

Linting & Formatting

Error Handling

Development Tools

Local Development

Performance

Process Management

Database

Supported Databases

Migration System

Production Optimizations

Rollup (Build)

CSS Optimization

Composer Scripts

Development Server

NPM Scripts

Version Summary

Core Dependencies

Development Dependencies

System Requirements

License