Server Requirements

To run SpotVibe successfully, your web server must meet the following minimum environment requirements:

Core Environment

To run SpotVibe successfully, your web server must meet the following minimum environment specifications:

Component	Required Version	Details & Purpose
PHP	`8.4+` (Strictly Required)	The core programming language. PHP 8.4+ is required for Laravel 13 package dependencies and type safety.
Database	`MySQL 8.4+` or equivalent	Relational database storage. Fully compatible with MySQL 8.4+, PostgreSQL, or SQLite.
Web Server	`Apache 2.4+` or `Nginx`	Server engines. Apache requires `mod_rewrite` enabled; Nginx requires standard Laravel location blocks.

⚠️ CRITICAL: Running this application on PHP 8.3 or below will result in composer dependency resolution failure. Ensure your local and production environments are running PHP 8.4 or higher.

Required PHP Extensions

The application checks for these extensions during the web setup process:

PHP Extension	Required Status	Purpose & Features Affected
`bcmath`	Required	Performs precise arbitrary precision mathematics for billing and financial calculations.
`ctype`	Required	Checks character types and string formatting patterns.
`fileinfo`	Required	Detects secure mime-types of files uploaded by users.
`gd`	Required	Enables image processing (creating thumbnails, resizing logos/avatars).
`json`	Required	Processes structured JSON payloads and API data transfers.
`mbstring`	Required	Handles multibyte character encodings (crucial for multi-language translations and UTF-8 characters).
`openssl`	Required	Secures data encryption, decryption, and secure session token generation.
`pdo`	Required	Establishes database connectivity (requires active MySQL/PgSQL database drivers).
`tokenizer`	Required	Translates code symbols during compilation of Blade templates.
`xml`	Required	Processes XML streams and documents.
`zip`	Required	Handles ZIP archives during the automatic core update extraction.

Directory Permissions

Ensure the web server user (e.g., www-data) has write permissions to these paths:

Directory / File	Numeric Code	Textual Permissions	Purpose & Usage
`storage/` (Recursive)	`755` (or `775`)	`drwxr-xr-x` (Read/Write/Execute)	Stores application-generated data such as logs, cache, framework sessions, and private database files.
`public/storage/` (Recursive)	`755` (or `775`)	`drwxr-xr-x` (Read/Write/Execute)	Physical directory for user-uploaded media files (venue images, logos, avatars). Must be publicly accessible.
`bootstrap/cache/` (Recursive)	`755` (or `775`)	`drwxr-xr-x` (Read/Write/Execute)	Stores Laravel's boot-optimization cache files (compiled routes and configurations) for fast performance.
`.env` (File)	`644` (or `664`)	`-rw-r--r--` (Read/Write)	Holds database credentials and configuration keys. Must be temporarily writable during the installation wizard.