Skip to content

jeremehancock/AI-Game-Collection

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

AI Game Collection

A collection of browser-based games created using AI assistance, featuring minimal code modifications. Experience engaging gameplay with a modern, responsive interface at AI Game Collection.

๐ŸŽฎ Available Games

Nerdle

A nerdy twist on the famous word game. Guess the hidden "nerdy" word in 6 tries.

Pipes

Connect the pipes to create a continuous flow. Test your logical thinking skills with this challenging puzzle game that requires strategic planning and spatial awareness.

Memory

A classic card-matching game that helps improve concentration and recall abilities. Test your memory by finding matching pairs of cards in this timeless brain-training exercise.

Minesweeper

Classic Minesweeper game with a modern touch. Clear the board without hitting any mines in this strategic puzzle game.

Snake

Classic snake game with a modern twist. Eat the food, grow longer, and try not to hit the walls or yourself!

Soccer Juggle

Keep the soccer ball in the air for as long as possible. Challenge yourself to achieve your highest juggling streak in this addictive skill-based game.

Water Ring Toss

Test your skill and patience in this classic water game! Use precision to land all the rings onto the pegs. How many can you score? (Mobile Only)

Waveform

Guide particles to their targets by shaping a wave using frequency, amplitude, and phase controls while avoiding obstacles in this unique physics puzzle.

Bubble Pop

Pop the bubbles before they escape! A fast-paced game of precision and reflexes that will keep you on your toes.

Breakout

Break the bricks, level up, and beat your high score! A fast-paced game of skill and strategy for all ages.

Space Shooter

Pilot your spaceship and navigate through an asteroid field. Shoot or evade asteroids in this fast-paced arcade challenge.

๐Ÿ“ธ Screenshots

Game Menu Nerdle Pipes Puzzle Memory Game Minesweeper Snake Game Soccer Juggle Game Water Ring Toss Waveform Bubble Pop Breakout Space Shooter

๐Ÿš€ Features

  • Clean, modern UI with a dark theme
  • Responsive design that works on all devices
  • Smooth transitions and animations
  • Easy navigation between games
  • Fullscreen game mode with quick return to menu
  • Minimalist design focused on gameplay

๐Ÿ› ๏ธ Technical Details

The site is built using:

  • HTML5
  • CSS3 (with modern features like CSS Grid and Flexbox)
  • Vanilla JavaScript
  • SVG icons for game representations
  • Responsive iframe implementation for game loading

๐ŸŽจ Design Features

  • Gradient backgrounds
  • Hover animations
  • Responsive card layout
  • Adaptive spacing and sizing
  • Accessibility considerations

๐Ÿ“ฑ Responsive Design

The site adapts seamlessly to different screen sizes:

  • Desktop: Full grid layout
  • Tablet: Adjusted card sizes
  • Mobile: Single column layout with optimized spacing

๐ŸŒ Browser Support

Works on all modern browsers including:

  • Chrome
  • Firefox
  • Safari
  • Edge

๐Ÿ”„ Usage

๐ŸŒ Website Access

Visit AI Game Collection and click on any game card to start playing. Use the back button in the bottom-left corner to return to the game selection screen.

๐Ÿ“ฑ Progressive Web App (PWA)

Install the collection as a PWA for a native app-like experience:

iOS Installation

  1. Open Safari and visit AI Game Collection
  2. Tap the Share button (square with arrow)
  3. Scroll down and tap "Add to Home Screen"
  4. Choose a name and tap "Add"

Android Installation

  1. Visit AI Game Collection in Chrome
  2. Tap the menu (three dots)
  3. Select "Add to Home Screen"
  4. Follow the prompts to install

๐Ÿ“ฒ Android App

For Android users preferring a native experience:

Get it on Google Play

๐Ÿณ Run Locally in Docker

You can run the game collection locally using Docker in two ways:

Option 1: Pull from Docker Hub

  1. Pull the image:
docker pull bozodev/ai-game-collection:latest
  1. Run the container:
docker run -d -p 38008:80 ai-game-collection:latest

Option 2: Build Locally

  1. Clone the repository:
git clone https://github.com/jeremehancock/AI-Game-Collection.git
cd ai-game-collection
  1. Build the Docker image:
docker build -t ai-game-collection .
  1. Run the container:
docker run -d -p 38008:80 ai-game-collection

Access and Management

Once running with either option:

  • Access the games by opening your browser and visiting http://localhost:38008/games/
  • View running containers: docker ps
  • Stop the container: docker stop <container-id>

๐Ÿค– AI Development

This project showcases the possibilities of AI-assisted development, with all games and the main interface being primarily built using AI tools, requiring minimal manual code adjustments.

๐Ÿ“ˆ Future Development

The collection is designed to be easily expandable, allowing for new games to be added while maintaining consistent design and user experience.


Created with AI assistance - Demonstrating the potential of AI in game development