Cloud Native Mauritius

Prerequisites

Clone the repository and ensure the followings are installed:

• PHP 8.2/8.3
• PHP Composer
• NPM
• SQLite

Install Dependencies

1. Install all necessary PHP dependencies.

   composer install
   

2. Install all necessary Node.js dependencies.

   npm install
   

Setting Up Laravel

1. Copy .env.example to .env in the project root.

   cp .env.example .env
   

2. Generate a unique application key.

   php artisan key:generate
   

Setting storage

```bash
php artisan storage:link
```

Setting Up SQLite for Development

1. Run the migration command

   php artisan migrate --seed
   # if already setup, run
   php artisan migrate:fresh --seed # This will clear the database with new data
   

2. When prompted to create a new SQLite database, type yes.

3. Seed the database with dummy data.

   php artisan migrate:fresh --seed
   

Run the Frontend Stack for Development

Ensure you are in the root directory and run the following commands:

1. Start the Laravel development server.

   php artisan serve # or use Herd (https://herd.laravel.com/)
   

2. Generate ide helper.

   composer run ide
   

3. Start the frontend development server.

   npm run dev
   

4. The application should now be accessible on port 8000 (or http://cloudnativemauritius.com.test on herd)

5. Advanced dev tool available on <host>/__clockwork

Testing on mobile

Set VITE_HMR_HOST to the local IP address of your machine. You'll also have to update the APP_URL

To quickly get the ip, run npm run dev -- --host and you'll see something like Network: http://x.x.x.x

VITE_HMR_HOST=192.168.100.200

Run php artisan serve --port 8000 --host 192.168.100.200 and npm run dev -- --host

In this case, if your phone is connected to the same network, you should be able to access the site on your phone on 192.168.100.200:8000