Installation

Setting up QoTrack locally requires a standard WAMP/XAMPP stack.

Prerequisites

Before you begin, ensure your local development environment meets the following requirements:

• PHP: Version 8.1 or higher.
• Database: MySQL 8.0+ or MariaDB.
• Composer: For managing PHP dependencies (like the Parsedown engine used for this documentation!).
• Node.js & npm: Required for compiling Tailwind CSS.

Step 1: Clone the Repository

Clone the project into your web server's root directory (e.g., c:\wamp64\www\qotrack).

git clone https://github.com/your-org/qotrack.git
cd qotrack

Step 2: Install Dependencies

You need to install both PHP and Node packages:

# Install PHP dependencies
composer install

# Install Tailwind & JS dependencies
npm install

Step 3: Environment Setup

Copy the example configuration file to create your local environment settings:

cp .env.example .env

Open the .env file and update your database credentials:

DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=qotrack_db
DB_USERNAME=root
DB_PASSWORD=

Step 4: Run the Compiler

To ensure all Tailwind CSS utility classes are generated correctly, run the build script:

.\build_css.ps1 -Watch

Leave this terminal window open while you work so styles update automatically!