Skip to content

limasid/Repo-Wars

Repository files navigation

RepoWars

name of the Header that represents the img

This project is a game that displays all the data of two randomly selected repositories and the user must choose the that has more stars. It was using React, Vite, TypeScript and relies on the GitHub public API for data retrieval.


Features

  • Functional Components in React
  • Project Organization using React and TypeScript
  • Responsive and Modern Design using CSS3
  • Flexbox and Layout Fundamentals
  • Usage of CSS Variables for Theme Creation
  • Custom Hooks Creation
  • Commits using Conventional Commits
  • Typing using TypeScript
  • Creation of Utilities

Live Version

Here you can start the game and understand its essence, Let's Play?.

Installation

To use this project, you need to follow these steps:

  1. Clone the repository: git clone https://github.com/username/repo-name.git
  2. Install the dependencies: npm install or yarn install
  3. Run the application: npm run dev or yarn dev

Note: This project uses "Vite" to run locally. Make sure to run the project using npm run dev or yarn dev instead of npm start or yarn start.

Used Tools

This project uses the following tools:

Theme

This project uses CSS variables to set up the theme. Here are the variables used and their descriptions:

  • Button: Personalized whith effect
  • --color-primary: Primary color used for headings
  • --color-secondary: Secondary color used for background and borders
  • --color-highlight: Highlight color used for interactive elements
  • --color-danger: Color used to indicate errors or warnings
  • --color-light: Light color used for text and background
  • --color-shade: Darker shade used for text and background
  • --color-darkish: Darkish color used for text and background
  • --color-dark: Dark color used for text and background
  • --color-darkest: Darkest color used for text and background

To customize the theme, simply modify the values of the variables in the src/app.css file.

Usage

After the application is running, the game will start automatically. The user must choose between the two repositories presented on the screen, and the game will display the result. The user can play again by clicking the "Play Again" button.

Contributing

To contribute to this project, please follow these guidelines:

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit them using Conventional Commits
  4. Push to the branch: git push origin feature/your-feature-name
  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Credits

This project was created by arthur404dev. And custom by Sidney Lima.

Releases

Packages

Contributors

Languages