A faithful recreation of the classic Pokemon Red/Blue games built with React and TypeScript https://gameboy-52d09.web.app/
Find a file
Chase Manning e3bbb53eb4
Merge pull request from chase-manning/update-readme-text
📝  Remove the word faithful
2025-06-13 09:44:06 +01:00
.firebase 🚀 add movement to gameboy keypad 2023-09-05 13:57:00 +03:00
.github 🔧 add feature request template 2025-04-29 21:14:56 +01:00
public 🔍 add seo metadata 2025-04-29 21:29:30 +01:00
scripts add script to download moves 2023-09-18 18:38:05 +01:00
src 📝 update pallet town text 2025-04-29 21:08:23 +01:00
.firebaserc 👷 setup ci/cd 2023-09-05 09:39:12 +03:00
.gitignore 🙈 add comms to gitignore 2023-09-15 16:24:04 +01:00
CONTRIBUTING.md 📝 add contribution guide 2025-04-29 21:14:22 +01:00
firebase.json 👷 setup ci/cd 2023-09-05 09:39:12 +03:00
LICENSE 📄 add license 2025-04-29 21:14:29 +01:00
package.json 🚨 fix warning 2023-09-23 16:14:46 +01:00
README.md 📝 remove the word faithful 2025-06-13 09:37:26 +01:00
TODO.md 💡 prioritise tasks 2024-03-31 14:12:00 +01:00
tsconfig.json 🎉 setup boilerplate 2023-09-04 23:31:03 +03:00
yarn.lock 🚨 fix warning 2023-09-23 16:14:46 +01:00

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.