Leasing & rent website to showcase the dealer's car listings

Developed in Laravel with Docker for easy use & implementation.

Contents

• Tech stack
• Installation
• Configuration
• Release notes
• Scripts
• Development

Tech stack

🛠️ Environment	Docker
💻 Backend	PHP 8 (with OPcache & JIT compiler) - Laravel
🌐 Frontend	Blade - Bootstrap - SASS - JavaScript ES6
🛢 Database	MySQL 8
🗄️ Server	Nginx 1.21

Installation

To get started, make sure you have Docker installed on your system, and then clone this repository.

Configuration

1. Update hosts - add 127.0.0.1 metzcars.local
2. Add .docker/certs/metzcars.crt certificate to trust store
3. Copy .env file cp .env.example .env and setup env variables
4. Run docker-compose -f docker-compose.local.yml up -d
5. Install dependencies & build assets:
   1. ./bin composer install
   2. ./bin yarn dev
   3. ./bin php artisan migrate

That's it! The website is up and running: https://metzcars.local

Scripts

In the root of the project directory you can run multiple scripts to ease development:

1. ./bin : Used to run commands inside the app docker container
2. ./cache : Clear all laravel cache configs

Release Notes

1. Pull code from main git repo
2. If necessary:
   1. Run migrations (in project root) : ./bin php artisan migrate
   2. Install new dependencies (in project root) : ./bin composer install
   3. Build frontend assets (in project root) : ./bin yarn production
   4. Restart/rebuild docker images/containers

Development

• Each feature/task/issue is developed on a separate branch
• SOLID
• Mobile first design
• BEM methodology for CSS
• Translations ordered alphabetically for ease of use