WePlayDOS

WePlayDOS brings classic DOS games to modern browsers using cutting-edge technology. Experience your favorite retro games with ease - no downloads or complex setups required.

🎮 Live version available at weplaydos.games

✨ Features

• Instant Browser Play: No downloads needed - play DOS games directly in your browser
• 150+ Classic Games: Large collection of carefully curated DOS titles
• Powered by js-dos: Built on the robust js-dos emulator for authentic gaming experience
• Modern UI: Clean, responsive interface built with React/Gatsby
• Cross-Platform: Works on all modern browsers and devices

🚀 Getting Started

Prerequisites

• Node.js 18+ (LTS version recommended)
• npm or yarn package manager
• Modern web browser (Chrome, Firefox, Edge, etc.)

Development Setup

1. Clone the repository:

   git clone https://github.com/muditjuneja/weplaydos.git
   cd weplaydos

2. Install dependencies:

   npm install

3. Start the development server:

   npm run develop

4. Visit http://localhost:8000 in your browser.

🎮 Adding Game ROMs

Due to copyright reasons, game ROM files are not included in this repository. To add games:

1. Download ROM files from our Google Drive link.
2. Place ROM files in the /static/roms directory.

🛠️ Technology Stack

• Frontend: React, Gatsby
• Emulation: js-dos
• Styling: Carbon Design System

👥 Contributing

Contributions welcome! Please read our Contributing Guide first.

Steps to Contribute:

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature/amazing-feature

3. Commit changes:

   git commit -m 'Add amazing feature'

4. Push to the branch:

   git push origin feature/amazing-feature

5. Open a Pull Request.

💬 Community & Support

• Join our Discord: Discord Invite Link
• Report bugs: Via GitHub Issues

📝 License

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

---

Built with ❤️ by DOS gaming enthusiasts. Happy retro gaming!