Skip to content

README.md

Latest commit

 

History

History
73 lines (51 loc) · 1.7 KB

README.md

File metadata and controls

73 lines (51 loc) · 1.7 KB

LNU Student Square

This repository contains the IT-105 Mobile Development project finalized as LNU Student Square.

The authoritative scope is documented in FINAL_SCOPE.md. Some package names, environment defaults, and internal identifiers still use the earlier working title LNU Marketplace; they are being left in place unless a scope-alignment change specifically requires otherwise.

This repository contains:

  • laravel-backend - Laravel 12 REST API
  • flutter-frontend - Flutter mobile app
  • docker-compose.yml - local development stack
  • docker-compose.prod.yml - EC2 / production-oriented Docker stack

Backend (Laravel + Docker)

  1. Start services:
docker compose up -d --build
  1. Install PHP dependencies:
docker compose exec app composer install
  1. Prepare environment:
cp laravel-backend/.env.example laravel-backend/.env
docker compose exec app php artisan key:generate
  1. Run migrations and seeders:
docker compose exec app php artisan migrate
docker compose exec app php artisan db:seed
  1. Run tests:
docker compose exec app php artisan test --filter=AuthTest

EC2 Deployment Stack

Use the production compose file when deploying to EC2 so only Nginx is public on port 80 by default:

docker compose --env-file laravel-backend/.env -f docker-compose.prod.yml up -d --build

Optional phpMyAdmin access stays disabled by default and only starts when you explicitly opt into the admin profile.

Frontend (Flutter)

cd flutter-frontend
flutter pub get
flutter run --dart-define=API_BASE_URL=http://10.0.2.2:8082

Use http://127.0.0.1:8082 instead when running on desktop or an iOS simulator.