GeeXPert

Track your games, level up your experience.

Every hero needs a quest log. Keep track of your played, pending and completed games as you embark on epic adventures across diferent worlds. From indie gems to AAA titles, make sure no game gets left behind.

GeeXPert is a web application for video game fans. In GeeXPert you can discover video games, create your own video game collection and track the progress of them. Also, you can discover video games based on your tastes through our artificial intelligence assistant.

I hope you enjoy it - RedondoDEV

Table of Contents

• Images
• Technologies
• Code
• Resources
• Installation
• Author
• License

Images

Home	Trending Games
Rated Games	Trending Games
Sign In	Sign Up
Collection	Recommendations
Card out of Collection	Card in Collection

Technologies

• Java
• Spring Boot
• Spring Web
• Spring Security
• JWT Authentication
• Spring Data JPA
• Hibernate
• MySQL
• TypeScript
• Angular
• Angular Material
• Node JS
• HTML5
• Tailwind CSS
• Ollama
• llama3.2:3b
• Maven
• Postman
• Docker

Code

The source code can be found at the following links:

• GeeXPert-Backend
• GeeXPert-Frontend

NOTE: The installation process and more details about the code are in these repositories.

Resources

• https://github.com/ollama/ollama
• https://api-docs.igdb.com/#getting-started

Installation

🎮 GeeXPert Installation Guide

This guide describes the necessary steps to run the GeeXPert application on your local computer.

---

🔧 Backend

1. Clone the Repository

Go to the official repository: GeeXPert-Backend

1. Open the command console
2. Navigate to the path where you want to save the project
3. Execute the following command:

git clone https://github.com/RedondoDev/GeeXPert-Backend.git

2. Install Docker Desktop

1. Download and install Docker Desktop from: Docker Desktop for Windows
2. During installation, a window will appear requesting the installation of the WSL subsystem
3. Press any key to proceed with the installation
4. Once installed, open Docker Desktop so the service is running (you can minimize the application)

3. Configure Environment Variables

1. Navigate to the root folder of the cloned project
2. Create a file named .env
3. Copy the following content into the file:

DATABASE_URL=jdbc:mysql://mysql:3306/GeeXPert?allowPublicKeyRetrieval=true&useSSL=false
DATABASE_USERNAME=
DATABASE_PASSWORD=
IGBD_ID=
IGBD_KEY=
JWT_KEY=

4. Complete the Environment Variables

You must fill in the following parameters:

DATABASE_USERNAME

• Database username
• No spaces or special characters

DATABASE_PASSWORD

• Database password

IGBD_ID and IGBD_KEY

• Register with the IGDB API following this guide: IGDB Account Creation
• Once you obtain your ID and KEY, set them in the corresponding variables

JWT_KEY

• Generate a JWT key from: JWT Secret Generator
• Important: Select a length of 256 bits
• Copy the generated key using the copy button

5. Configure Ollama

Execute the following commands in the console:

# Access the Ollama container
docker exec -it ollama /bin/sh

# Download the AI model
ollama pull llama3.2:3b

# Verify the installation
ollama list

6. Run the Backend

1. Open a command console
2. Navigate to the root path of the backend project
3. Execute:

docker compose up --build

---

🖥️ Frontend

1. Clone the Repository

Go to the official repository: GeeXPert-Frontend

1. Open the command console
2. Navigate to the path where you want to save the project
3. Execute:

git clone https://github.com/RedondoDev/GeeXPert-Frontend.git

2. Run the Frontend

1. Open a command console
2. Navigate to the root path of the frontend project
3. Execute:

docker compose up --build

---

🚀 Application Access

Once all steps are completed, you can access the web application from your browser at:

http://localhost:4200/

---

📧 Support

For any issues or problems with the installation, contact us:

Email: JavierRedondoDev@gmail.com

Author

RedondoDEV

License

This project is licensed under the MIT License