From 45d2dc33a1cb17cb143cb9656c940c825003f89e Mon Sep 17 00:00:00 2001 From: HoussamMrabet Date: Mon, 19 Jun 2023 19:09:33 +0100 Subject: [PATCH] add README.md --- README.md | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..b3b686b --- /dev/null +++ b/README.md @@ -0,0 +1,80 @@ +# GameHub + +GameHub is a React web application built with Vite and TypeScript. It provides a platform for discovering and exploring games across various platforms. The application utilizes Chakra UI for design, Axios for API requests, and relies on the RAWG.io API for game data. + +## Features + +- Browse games across different genres and platforms. +- View detailed descriptions and information about individual games. +- Search for specific games. + +## Installation + +To get started with GameHub, follow these steps: + +1. Clone the repository: + +```bash +git clone https://github.com/HoussamMrabet/game-hub.git +``` + +2. Navigate to the project directory: + +```bash +cd game-hub +``` + +3. Install the dependencies: + +```bash +npm install +``` + +4. Create a `.env` file in the root directory and provide your RAWG.io API key. You can obtain an API key by signing up at [RAWG.io](https://rawg.io/apidocs). + +``` +REACT_APP_RAWG_API_KEY=your-api-key +``` + +## Usage + +Once you have installed the dependencies and provided the API key, you can start the development server: + +```bash +npm run dev +``` + +This command will launch the application in development mode, and the server will be accessible at your `localhost`. + +## Dependencies + +GameHub utilizes the following major dependencies: + +- React: JavaScript library for building user interfaces. +- Vite: Next-generation frontend build tooling. +- TypeScript: Typed superset of JavaScript. +- Chakra UI: Modular component library for React. +- Axios: Promise-based HTTP client for making API requests. + +For the complete list of dependencies, please refer to the `package.json` file. + +## Contributing + +Contributions to GameHub are welcome! If you find any bugs, issues, or have suggestions for improvements, please open an issue or submit a pull request. + +When contributing, please adhere to the existing code style and follow the established patterns and conventions. + +## License + +GameHub is open source and distributed under the [MIT License](LICENSE). + +## Acknowledgements + +- [RAWG.io](https://rawg.io/) for providing the game data API. +- [Vite](https://vitejs.dev/) for the efficient build tooling. +- [Chakra UI](https://chakra-ui.com/) for the sleek and accessible component library. +- [Axios](https://axios-http.com/) for simplified HTTP requests. + +## Contact + +For any inquiries or feedback, please contact [houssammrabet5@gmail.com](mailto:houssammrabet5@gmail.com). \ No newline at end of file