INSTALLATION

ASHMERLYN PORTAL, A Laravel Full stack application for automating academic result collation and pyschomotor/psychosocial grading for Ash Merlyn School.

PREREQUISITES

The following software programs are needed to run this project

Software	Minimum Version	Guides
PHP	8.2.x	Install PHP
MySQL	5.7	Install MySQL5.7
Composer	2.x	Download Composer
Node	16.20.x	Download Node Version Manager

SETTING UP THE PROJECT

1. Clone the repo:

$ git clone git@github.com:doobie-droid/ashmerlynportal.git && cd ashmerlynportal

2. Copy the contents of .env.example file to your .env

$ cp .env.example .env

3. Install php and node packages

$ composer install && npm install

4. Generate your application encryption key

$ php artisan key:generate

DATABASE

Run the command below so that you can migrate and seed your DB

$ php artisan migrate --seed

SERVING APPLICATION

Run the laravel application in your Terminal

$ php artisan serve

Open another terminal and run your Node for asset bundling

$ npm run dev

NOTE

After serving your laravel app locally, Visit http://localhost:8000/login-dev to log in as an admin

EXTRAS

In case you want to use a free mailing service with unlimited usage, check out my terse guide for setting up mailpit for local development.