Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AngelZurita28/VeranoRegional/llms.txt

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

This guide shows you how to install Verano Regional on your local machine for development or evaluation. The platform runs on a standard Apache + PHP + MySQL stack and requires no build tools or package manager beyond cloning the repository.

Prerequisites

Before you start, make sure you have the following installed:
  • Apache (or an equivalent stack like XAMPP, WAMP, or Laragon) with mod_rewrite enabled
  • PHP 7.4 or higher
  • MySQL 5.7 or higher (or MariaDB equivalent)
  • Git to clone the repository
XAMPP is the easiest option on Windows and macOS. It bundles Apache, PHP, and MySQL in a single installer available at apachefriends.org.

Installation steps

1

Clone the repository

Open a terminal, navigate to your web server’s document root (htdocs for XAMPP on Windows/macOS, or www for other setups), and clone the repository:
git clone https://github.com/AngelZurita28/VeranoRegional.git
cd VeranoRegional
The folder must live directly inside htdocs or www so the platform is reachable at http://localhost/VeranoRegional/. Placing it in a subdirectory will change the URL path accordingly.
2

Create the database

Open your MySQL client (phpMyAdmin, MySQL Workbench, or the command line) and create a database named verano:
CREATE DATABASE verano CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Then import the bundled SQL file to create the schema and seed initial data. The repository includes verano2026.sql; if that file is not present, use schema.sql:
mysql -u root -p verano < verano2026.sql
3

Create the .env file

Create a file named .env in the project root. The platform’s EnvLoader reads this file on every request and injects its values into $_ENV and $_SERVER.
DB_HOST=localhost
DB_NAME=verano
DB_USER=root
DB_PASS=your_password
SMTP_HOST=smtp.example.com
SMTP_USER=you@example.com
Replace your_password with your MySQL root password. Add your SMTP credentials if you want OTP verification emails to work.
Never commit .env to version control. The repository already includes it in .gitignore. Keep your credentials out of source code.
4

Start your web server and open the app

Start Apache and MySQL through your XAMPP control panel (or equivalent), then open your browser and navigate to:
http://localhost/VeranoRegional/
You should see the Verano Regional login screen. From here you can register the first administrator account or log in with any seeded credentials included in the SQL file.
If you see a blank page or a database connection error, double-check that the DB_* values in your .env file match your MySQL setup, and confirm that the verano database was created and the SQL file was imported successfully.

Project structure

After cloning, the repository has the following layout:
VeranoRegional/
├── assets/         # Static files: CSS, JS, images
├── config/         # Database connection (conn.php) and constants
├── controllers/    # Business logic — one file per feature area
├── helpers/        # Utilities including EnvLoader.php
├── models/         # Database query layer
├── services/       # External integrations (e.g. email)
├── views/          # HTML templates
├── uploads/        # User-uploaded files (documents, reports)
├── index.php       # Main router — all requests pass through here
├── api.php         # Async endpoints
└── .env            # Local configuration (excluded from git)
All HTTP requests are routed through index.php, which maps the action query parameter to the correct controller and method.

Build docs developers (and LLMs) love