Setup Guide for Running Locally

Prerequisites

  • PHP
  • Composer
  • Node.js & npm
  • PostgreSQL

See the prerequisites page for detailed instructions.

Steps

Clone the repository

git clone https://github.com/jonathank1906/Web-Technologies-Project.git
cd Web-Technologies-Project

Install PHP dependencies

composer install

Copy and configure environment file

cp .env.example .env

Copy and paste from here.

Install Node.js dependencies

npm install

Build frontend assets

npm run build

Create the PostgreSQL database

psql -U postgres

Then, in the PostgreSQL prompt, run:

CREATE DATABASE laravel;

Type \q to exit.

Run database migrations

Apply migrations:

php artisan migrate

Running the project

Start the Vite development server (in one terminal):

npm run dev

Start the Laravel server (in another terminal):

php artisan serve

Access the app by visiting http://localhost:8000 in your browser.