Installation Guide

Prerequisites

PHP 8.3+ with the following extensions: pdo_mysql, redis, gd/imagick, mbstring, xml, zip, bcmath, intl.
MySQL 8.0+ or MariaDB equivalent.
Redis 7.0+ (for caching, sessions, and queues).
Node.js 20+ and npm (for asset compilation).
Composer 2.x (for PHP dependency management).
Mailpit (optional, for local development).

Clone the repository:

git clone https://github.com/your-repo/eventra.git
cd eventra

Set up environment variables:

cp .env.example .env
php artisan key:generate

Configure .env: Edit your .env file and set the correct database, Redis, and mail server credentials.
Run migrations and seed the database:
```
php artisan migrate --seed
```
Initialize Filament Shield:
```
php artisan shield:install
```
Link storage:
```
php artisan storage:link
```
Build frontend assets:
```
npm run build
```
Start the development server:
```
php artisan serve
```
Your application will be available at http://localhost:8000.

Asset Compilation: Use npm run dev to watch for changes during development.
Queues: Use php artisan queue:listen or set up Horizon for local background job monitoring.
Telescope: Visit /telescope to inspect application requests, exceptions, and more.
Mailpit: If local development mail is configured, the web interface is usually at http://localhost:8025.