Skip to content

chinesepowered/kiroween

Repository files navigation

🎃 Kiro Scarecade 👻

A Halloween-themed retro arcade console featuring three spooky pixel-art games, built entirely with Kiro's spec-driven development workflow.

Kiro Scarecade Next.js TypeScript

🎮 The Games

👻 Ghoul Maze

A Pac-Man inspired maze game where you collect souls while avoiding monsters. Grab power-ups to transform into a werewolf and turn the tables on your pursuers!

⚔️ Crypt Crawler

A side-scrolling beat 'em up brawler. Fight waves of skeletons, zombies, vampires, and ghosts in a spooky graveyard setting.

🎃 Pumpkin Smash

A whack-a-mole style reaction game. Smash evil pumpkins for points, but spare the friendly ghosts or lose your score!

🏆 Hackathon Category

Costume Contest - A haunting user interface with polished, unforgettable spooky design elements that enhance the arcade experience.

✨ Features

  • Unified Kiros Currency - Earn Kiros across all games, persisted to local storage
  • Spooky Audio System - Halloween-themed music and sound effects
  • Pixel Art Aesthetics - Retro 16x16/32x32 sprite-based graphics
  • Responsive Controls - Keyboard (WASD/Arrows) and mouse support
  • Dark Halloween Theme - Deep purples, blood reds, and ghostly greens

🚀 Getting Started

# Install dependencies
pnpm install

# Run development server
pnpm dev

# Build for production
pnpm build

Open http://localhost:3000 to play!

🎮 Controls

Game Controls
Ghoul Maze Arrow Keys or WASD to move
Crypt Crawler ← → Move, ↑ Jump, J or Space to Attack
Pumpkin Smash Mouse click to smash targets
All Games ESC to pause

🏗️ Project Structure

├── .kiro/
│   └── specs/
│       └── kiro-scarecade/
│           ├── requirements.md    # EARS-compliant requirements
│           ├── design.md          # Architecture & correctness properties
│           └── tasks.md           # Implementation checklist
├── app/                           # Next.js App Router pages
├── components/                    # React UI components
├── lib/
│   ├── audio/                     # Web Audio API system
│   ├── engine/                    # Game loop, input, collision
│   ├── games/                     # Individual game implementations
│   ├── sprites/                   # Pixel art rendering
│   ├── state/                     # Kiros currency & persistence
│   └── transitions/               # Screen transition effects
└── public/audio/                  # Music and sound effects

📜 License

MIT License - See LICENSE file for details.

About

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors