Skip to content

chase-manning/pokemon-js

Repository files navigation

Pokemon JS

A recreation of the classic Pokemon Red/Blue games built with React and TypeScript. This project aims to recreate the original Pokemon experience in the browser, maintaining the authentic feel while leveraging modern web technologies.

image

Features

  • 🎮 Classic Pokemon gameplay mechanics
  • 🗺️ Multiple maps and locations from the original games
  • ⚔️ Turn-based battle system
  • 🎵 Original game music and sound effects
  • 📱 Responsive design with GameBoy-style interface
  • 💾 Save/Load game functionality
  • 🏪 PokeMart and Pokemon Center implementations
  • 📦 Item and inventory system
  • 🎯 Trainer battles
  • 🌿 Wild Pokemon encounters
  • 📱 Mobile-friendly controls

Tech Stack

  • React 18
  • TypeScript
  • Redux Toolkit for state management
  • Styled Components for styling
  • Firebase for hosting

Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • Yarn package manager

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/pokemon-js.git
cd pokemon-js
  1. Install dependencies:
yarn install
  1. Start the development server:
yarn start

The game will be available at http://localhost:3000

Controls

  • Arrow Keys: Move character
  • Space: Menu
  • Enter: Confirm
  • Space: Pause

Project Structure

  • /src/components: React components for game UI
  • /src/maps: Game map data and configurations
  • /src/state: Redux store and state management
  • /src/assets: Game assets (sprites, music, etc.)
  • /src/styles: Global styles and theme configurations

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Special thanks to

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This is a fan-made project and is not affiliated with or endorsed by Nintendo, Game Freak, or The Pokemon Company. All Pokemon-related content is property of their respective owners.

About

A faithful recreation of the classic Pokemon Red/Blue games built with React and TypeScript

Topics

Resources

License

Stars

Watchers

Forks