Game-Vault

A simple, browser-based vault and hub for playing a collection of classic and modern mini-games built purely with HTML, CSS, and JavaScript. Check out here: https://joshinx17.github.io/Game-Vault/

🌟 About the Project

Game-Vault is a personal project intended to serve as a single, easily accessible platform for various web-based games. The goal is to provide a clean, fun, and responsive interface where users can quickly browse and launch games directly in their browser without any external dependencies or installations.

The entire project is built on the core trio of web development languages, making it a great resource for learning how to structure and implement simple game logic in Vanilla JavaScript.

🚀 Features

• Central Game Hub: A single index.html page to list all available games.
• Pure Web Tech: Games are implemented using only HTML5, CSS3, and JavaScript.
• Responsive Design: Optimized for play across different screen sizes (desktop, tablet, and mobile).
• Modular Code: Game logic is separated into dedicated files (games.js, script.js) for easy expansion and maintenance.

🛠️ Technologies Used

Technology	Purpose
HTML5	Structure and game display.
CSS3	Styling, layout, and visual design.
JavaScript	Core game logic, state management, and interaction.

💻 Getting Started

This project is a static web application and requires no complex build process or server-side dependencies.

Prerequisites

You only need a modern web browser (Chrome, Firefox, Edge, Safari) to run the project.

Installation

1. Clone the repository:

   git clone [https://github.com/Joshinx17/Game-Vault.git](https://github.com/Joshinx17/Game-Vault.git)

2. Navigate to the project directory:

   cd Game-Vault

3. Open the file: Locate the index.html file in the root directory and open it with your web browser.

   open index.html

   (or simply double-click the file)

📁 Project Structure

The repository is structured to separate core hub logic from individual game files:

Game-Vault/
├── .github/
│   └── workflows/  \# GitHub Actions for CI/CD or deployment
├── game.html       \# Template file for launching an individual game
├── games.js        \# JavaScript file containing data/config for all games
├── index.html      \# Main landing page (the Game Hub)
├── script.js       \# Core JavaScript logic for the game vault (e.g., navigation)
├── style.css       \# Global styles for the hub interface
└── README.md       \# This file

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have an idea for a new game to add, a feature enhancement, or a bug fix, please follow these steps:

1. Fork the project.
2. Create your Feature Branch (git checkout -b feature/AmazingGame).
3. Commit your changes (git commit -m 'Feat: Add Amazing Game to the vault').
4. Push to the Branch (git push origin feature/AmazingGame).
5. Open a Pull Request.

---

Developer: Joshinx17