BREWherehouse

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

Technologies

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

Features

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

  Getting Started

Prerequisites

• VSCode
• Docker

Installation

1. Clone the repository:

   git clone [email protected]: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