dipsnc/Games-Hub

React.js + Vite

โ˜… 0Forks 0JavaScriptGitHub โ†—Compare

README

๐ŸŽฎ Fun Games Hub

Fun Games Hub is an open-source collection of mini-games built with React + Vite. It provides a modular platform where developers can add new games, improve existing ones, or enhance the UI/UX. Players can enjoy classic games like Tic Tac Toe, Memory Match, and Snake directly in the browser.

This repository is part of Hacktoberfest ๐Ÿ‚, and contributions are highly encouraged! Add new games to the homepage, implement new features in existing games, or improve the overall design and interactivity.

Maintainer GauravGirkar

โœจ Features (Planned & Ongoing)

  • ๐Ÿ•น๏ธ Mini-Games Hub โ€“ Play multiple games from a single platform
  • โŒ Tic Tac Toe โ€“ Classic 3x3 game
  • ๐Ÿƒ Memory Match โ€“ Flip cards and find pairs
  • ๐Ÿ Snake โ€“ Navigate the snake to collect food and grow
  • ๐Ÿงฉ Modular Game System โ€“ Easily add new games to the hub
  • ๐ŸŽจ Modern UI โ€“ Clean and responsive design with CSS
  • ๐Ÿ“ฑ Responsive Design โ€“ Works seamlessly on desktop and mobile
  • ๐Ÿ› ๏ธ Hacktoberfest-Friendly โ€“ Contributors can add new games, features, or UI improvements

๐Ÿ› ๏ธ Tech Stack

  1. Frontend: React 18, Vite
  2. Routing: React Router DOM
  3. State Management: React useState & useEffect (per-game)
  4. Styling: CSS / TailwindCSS compatible
  5. Other Utilities: None (can be added by contributors per game)

๐Ÿ“‚ Project Structure

fun-games-hub/ โ”œโ”€โ”€ public/ # Static assets (favicon, images) โ”œโ”€โ”€ src/ โ”‚ โ”œโ”€โ”€ components/ # Shared UI components (Nav, GameCard) โ”‚ โ”œโ”€โ”€ pages/ # Game pages (TicTacToePage, MemoryPage, SnakePage) โ”‚ โ””โ”€โ”€ games/ # Game implementations (TicTacToe, Memory, Snake) โ”œโ”€โ”€ index.html โ”œโ”€โ”€ styles.css # Global styles โ”œโ”€โ”€ package.json โ”œโ”€โ”€ vite.config.js โ”œโ”€โ”€ README.md โ”œโ”€โ”€ CONTRIBUTING.md โ””โ”€โ”€ ISSUE_TEMPLATE.md

Contributor Guidelines:

  • Add your game inside src/games/
  • Create a corresponding page in src/pages/
  • Link your game in App.jsx and the homepage (Home.jsx)
  • Update the homepage to display your game card

๐Ÿš€ Getting Started

  1. Clone the repository
  2. git clone https://github.com//games-hub.git
  3. cd fun-games-hub
  4. Install dependencies npm install or yarn install or pnpm install
  5. Start the development server npm run dev Open http://localhost:5173 in your browser

๐ŸŽฏ How to Contribute

  1. Fork the repository
  2. Create a new branch for your feature: git checkout -b feat-new-game
  3. Add your game in src/games/ and create a page in src/pages/
  4. Update the homepage (Home.jsx) with a new GameCard
  5. Commit your changes, push, and open a Pull Request

๐Ÿ’ก Suggestions for contributions:

  • Add new games (e.g., Chess, Connect 4, Pong)
  • Add features to existing games (scores, levels, themes)
  • Improve UI animations or responsiveness
  • Add game-specific settings or sound effects

Contributors

GauravGirkarKaleshi26AasthaOswalAdK819Khanvilkarshravani27

Issues