Skip to content

Latest commit

 

History

History
108 lines (77 loc) · 3.05 KB

README.md

File metadata and controls

108 lines (77 loc) · 3.05 KB

BREWherehouse

🍺 A Beer catalog featuring a login page and a paginated view of all available beers. 🍻

GitHub Actions PHP Test PHPStan

Technologies

  • PHP The 8.2 version of PHP, bringing new features and improvements.
  • Apache2 The web server for serving your PHP application.
  • Docker A containerization platform for packaging, distributing, and running applications.
  • !Laravel The backend framework for building robust and scalable web applications.
  • Vue.js The progressive JavaScript framework for building user interfaces.
  • Pest PHP A delightful PHP Testing Framework with a focus on simplicity.
  • JWT Token JSON Web Tokens for secure and stateless authentication.
  • Tailwind CSS

Features

  • 🚀 User Authentication: Secure login page for user authentication (JWT).
  • 🍺 Beer Catalog: Explore a wide variety of beers with pagination support.

Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone git@github.com:gianni/BREWherehouse.git
  2. Move to the directory:

    cd BREWherehouse
  3. Open VSCode:

    code .
  4. Start DevContainer:

    In the VSCode menu

    Riquadro Comandi > DevContainer: Rebuild and reopen in container

  5. Install php and npm packages:

    In the shell of the DevConatainer execute these commands.

    composer install
    npm install
  6. Create a .env file:

    cp .env.example .env
  7. Start Apache and ViteJs server:

    service apache2 start
    npm run dev
  8. Generate keys:

    php artisan key:generate
    php artisan jwt:secret
  9. Execute migration and seed the database:

    php artisan migrate
    php artisan db:seed
  10. Add local domain to the hosts file (root user):

    echo "127.0.0.1 www.brewherehouse.loc" >> /etc/hosts
  11. Point the browser to this url

    http://www.brewherehouse.loc:8080