Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AndresLopezCorrales/Boletilandia/llms.txt

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

This guide walks you through every command needed to get a fully working Boletilandia development environment running on your machine — from cloning the repository to seeing the application live in your browser. The entire stack (PHP backend, Vite asset pipeline, and database) is covered in the steps below.

​
Prerequisites

Before you begin, make sure the following are available on your system:
  • PHP ^8.2 with the pdo, pdo_sqlite (or pdo_mysql), mbstring, openssl, and tokenizer extensions enabled
  • Composer (latest stable)
  • Node.js and npm (Node 20 LTS recommended — the project was built with Node v20.11.1)
  • A database: SQLite (zero-config, default) or MySQL / MariaDB

​
Setup Steps

1

Clone the repository

Download the source code and enter the project directory.
git clone https://github.com/AndresLopezCorrales/Boletilandia.git
cd Boletilandia
2

Install PHP dependencies

Install all Composer packages, including Laravel 11, Jetstream, Livewire, Sanctum, and DomPDF.
composer install
PHP ^8.2 is required. Running composer install with PHP 8.1 or earlier will fail because composer.json declares "php": "^8.2".
3

Install Node dependencies

Install the JavaScript packages, including Vite, Tailwind CSS, and SweetAlert2.
npm install
This resolves both devDependencies (Vite ^5.0, Tailwind CSS ^3.4, @tailwindcss/forms, @tailwindcss/typography, PostCSS, Autoprefixer, Axios) and the production dependency — SweetAlert2 ^11.14.4.
4

Copy and configure the environment file

Create your local .env from the provided example, then generate the application encryption key.
cp .env.example .env
APP_KEY must be set before the application will boot. Running php artisan key:generate writes the key into your .env automatically. Never run the app with an empty APP_KEY.
Open .env in your editor and update at minimum APP_NAME, APP_URL, and your database credentials. See the Configuration page for a full reference of every variable.
5

Run database migrations

Apply all migrations to create the users, sessions, cache, jobs, personal_access_tokens, evento, seccion, and asiento tables.
php artisan migrate
Make sure your database is reachable and the credentials in .env are correct before running this command. The default DB_CONNECTION is sqlite, which will create a file at database/database.sqlite automatically. To use MySQL, set DB_CONNECTION=mysql along with DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, and DB_PASSWORD in your .env.
6

Create the storage symlink

Link public/storage to storage/app/public so that uploaded event images (stored under storage/app/public/imagen_path/) are accessible from the browser.
php artisan storage:link
7

Start the development servers

You need two processes running in parallel: the Laravel backend and the Vite asset server.
php artisan serve
Open http://localhost:8000 in your browser. Vite will hot-reload CSS and JavaScript changes instantly.
When deploying to production, run npm run build instead of npm run dev. This compiles and fingerprints all assets defined in vite.config.js (resources/css/app.css, resources/css/home-style.css, resources/css/galeria-style.css, resources/js/app.js, resources/js/get-attributes.js, and resources/js/comprar-boleto.js) into the public/build directory, ready to be served by your web server without a Vite process.

​
Quick-Reference Command Summary

git clone https://github.com/AndresLopezCorrales/Boletilandia.git && cd Boletilandia
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan storage:link
# Terminal 1
php artisan serve
# Terminal 2
npm run dev

Build docs developers (and LLMs) love

Get started for freeTalk to us