Skip to content

Latest commit

 

History

History
160 lines (125 loc) · 7 KB

README.md

File metadata and controls

160 lines (125 loc) · 7 KB

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