{"id":28364094,"url":"https://github.com/andowna9/myvideogamesxp","last_synced_at":"2026-04-14T04:02:50.750Z","repository":{"id":294965018,"uuid":"565877250","full_name":"Andowna9/MyVideogamesXP","owner":"Andowna9","description":"Videogames list tracking app","archived":false,"fork":false,"pushed_at":"2025-05-22T22:14:54.000Z","size":3160,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-24T00:35:47.701Z","etag":null,"topics":["chakra-ui","expressjs","fastapi","igdb","reactjs","videogames"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Andowna9.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-14T14:14:03.000Z","updated_at":"2025-05-22T22:14:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"4017f8f8-b9f4-4999-829f-23ba6945068e","html_url":"https://github.com/Andowna9/MyVideogamesXP","commit_stats":null,"previous_names":["andowna9/myvideogamesxp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Andowna9/MyVideogamesXP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andowna9%2FMyVideogamesXP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andowna9%2FMyVideogamesXP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andowna9%2FMyVideogamesXP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andowna9%2FMyVideogamesXP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Andowna9","download_url":"https://codeload.github.com/Andowna9/MyVideogamesXP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andowna9%2FMyVideogamesXP/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266143940,"owners_count":23883067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chakra-ui","expressjs","fastapi","igdb","reactjs","videogames"],"created_at":"2025-05-28T20:14:35.878Z","updated_at":"2026-04-14T04:02:45.721Z","avatar_url":"https://github.com/Andowna9.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MyVideogamesXP\n\n**MyVideogamesXP** is a web application that allows users to track their\ngames progress easily, as well as providing data about a wide variety\nof titles by means of [IGDB API](https://www.igdb.com/api) owned by Twitch.\n\n## Built With\n\n![React.js](https://img.shields.io/badge/React.js-blue?style=for-the-badge\u0026logo=react\u0026logoColor=cyan) \n![Node.js](https://img.shields.io/badge/node.js-339933?style=for-the-badge\u0026logo=Node.js\u0026logoColor=white)\n![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge\u0026logo=fastapi)\n![Nginx](https://img.shields.io/badge/Nginx-009639?logo=nginx\u0026logoColor=white\u0026style=for-the-badge)\n![MariaDB](https://img.shields.io/badge/MariaDB-003545?style=for-the-badge\u0026logo=mariadb\u0026logoColor=white)\n![MongoDB](https://img.shields.io/badge/-MongoDB-13aa52?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white\n)\n![Docker](https://img.shields.io/badge/docker-257bd6?style=for-the-badge\u0026logo=docker\u0026logoColor=white)\n\n## Architecture\n\nThe frontend is run as an Single Page Application (SPA) on the user's browser and accesses each of the microservices functionalities through a unified REST API.\n\n![Architecture](images/architecture.PNG)\n\n\n## Features\n\n- 🔐 Log in using Google or user/email combination.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/login.png\" width=\"400px\" /\u003e\n\u003c/p\u003e\n\n\n- 🔍 Search a huge catalog of games via IGDB.\n  \n![Login](images/game_search.PNG)\n\n\n- 📖 View game details to learn more about them.\n  \n![Login](images/view_game.PNG)\n\n- ⭐ Add your favorite games and begin tracking your progress.\n\n![Login](images/add_game.PNG)\n\n- 🛠️ Manage your list comfortably editing and removing game entries.\n  \n![Login](images/game_list.PNG)\n\n## Getting Started\n\nFollow these steps to set up the application locally.\n\n### Prerequisites\n- Docker\n- Docker Compose\n\n### Configuring Environment Variables\n\nBefore running the application, ensure you’ve created and properly configured the required `.env`. The repository includes sample `.env` files to guide you:\n- [frontend](./frontend/.env.sample)\n- [users-backend](./users-backend/.env.sample)\n- [videogames-backend](./videogames-backend/.env.sample)\n\nSome essential credentials you’ll need:\n\n- **Google OAuth Credentials** – Used for user authentication. Follow the [Google Developer Guide](https://developers.google.com/workspace/guides/create-credentials) to set them up.\n- **IGDB API Credentials (via Twitch OAuth)** – Required for accessing the game catalog. See the [IGDB API documentation](https://api-docs.igdb.com/#about) for details.\n\n\n### Running with Docker (Dev)\n\nTo get everything up and running (including the frontend), use:\n\n```bash\ndocker compose --profile frontend up -d\n```\n\n\n## API Endpoints\n\nCheck the following tables for further understanding of the available API endpoints per microservice.\n\n### 🧑 User Accounts – `/api/accounts`\n\n| Endpoint                  | Method | Description                     |\n| ------------------------- | ------ | ------------------------------- |\n| `/register`               | POST   | Register a new user.            |\n| `/auth/login`             | POST   | Log into an existing account.   |\n| `/auth/logout`            | POST   | Log out.                        |\n| `/users/me`               | GET    | Get authenticated user's data.  |\n| `/oauth/google/authorize` | GET    | Authorize with Google OAuth.    |\n| `/oauth/google/callback`  | GET    | Google authentication callback. |\n\n\n### 🎮 Video Games – `/api/videogames`\n\n| Endpoint         | Method | Description                              |\n| ---------------- | ------ | ---------------------------------------- |\n| `/igdb/\u003cid\u003e`     | GET    | Get game details by ID.                  |\n| `/igdb/search`   | GET    | Search for games.                        |\n| `/my-games`      | GET    | Get yor games list.                      |\n| `/my-games`      | POST   | Add a game to your list.                 |\n| `/my-games/\u003cid\u003e` | PUT    | Update tracking data of a specific game. |\n| `/my-games/\u003cid\u003e` | DELETE | Delete a game from your list.            |\n\n## License\n\nDistributed under the MIT License. See [License](LICENSE).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandowna9%2Fmyvideogamesxp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandowna9%2Fmyvideogamesxp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandowna9%2Fmyvideogamesxp/lists"}