GitHub

Official Open Source Repository

562 Stars โ€ข 305 Forks โ€ข 222 Open Issues

Visit GitHub

Welcome to OpenFront on GitHub!

๐ŸŽฎ Play free at openfront.io

๐Ÿงช Try the experimental build at beta.openfront.io

OpenFront.io is completely open source! Explore the source code, contribute to development, and help shape the future of this strategic browser game.

Repository stats last updated: July 6, 2025 at 10:03 AM

Repository Statistics

562
Stars
305
Forks
17
Releases
222
Open Issues

Technology Stack

TypeScript

92.2% of codebase

HTML

3.3% of codebase

CSS

2.1% of codebase

Shell

1.6% of codebase

Project Structure

Directory Structure

๐Ÿ“ /src
๐Ÿ“ /client - Frontend game client
๐Ÿ“ /core - Shared game logic
๐Ÿ“ /server - Backend game server
๐Ÿ“ /resources
- Static assets (images, maps, etc.)
๐Ÿ“ /tests
- Test files and configurations

Development Commands

  • npm run dev - Development mode
  • npm run format - Code formatting
  • npm run lint - Code linting
  • npm test - Run test suite

Open Source Licensing

OpenFront uses a multi-licensing approach to balance open source principles with project sustainability.

MIT License

Server and core game logic

The backend server code and core game mechanics are licensed under MIT, allowing maximum flexibility for developers and contributors.

GPL v3

Client-side code

The frontend client code is licensed under GPL v3, ensuring that modifications to the client remain open source.

CC BY-NC 4.0

Game assets

Non-commercial assets are licensed under Creative Commons, with special commercial exemption for OpenFront LLC.

How to Contribute

Getting Started

1
Join the Community

Request to join the development Discord server to connect with other contributors and get guidance.

2
Fork & Clone

Fork the repository on GitHub and clone it to your local machine:

git clone https://github.com/YOUR_USERNAME/OpenFrontIO.git
3
Install Dependencies

Install the required dependencies:

npm install
4
Start Development

Run the development server:

npm run dev

Contribution Areas

๐ŸŽจ UI/UX Improvements

Perfect for new contributors. Enhance the user interface and experience.

๐Ÿ› Bug Fixes

Help identify and fix issues to improve game stability and performance.

๐ŸŒ Translations

Help translate the game into different languages via Crowdin.

โš™๏ธ Core Features

For experienced contributors. Work on game mechanics and core systems.

๐Ÿ“š Documentation

Improve code documentation, guides, and help other developers understand the codebase.

Contribution Guidelines

Code Quality Requirements

  • โ€ข All code must be well-commented and follow existing style patterns
  • โ€ข New features should not break existing functionality
  • โ€ข Code should be thoroughly tested before submission
  • โ€ข All code changes in src/core MUST be tested
  • โ€ข Use npm run format and npm run lint

Pull Request Process

  • โ€ข Keep PRs focused on a single feature or bug fix
  • โ€ข Include screenshots for UI changes
  • โ€ข Describe what testing you've performed
  • โ€ข Be responsive to feedback and requested changes
  • โ€ข Wait for maintainer approval before merging

Progressive Contribution System

1 New Contributors

Limited to UI improvements and small bug fixes only

  • โ€ข Helps you become familiar with the codebase
  • โ€ข UI changes are easier to review and less likely to break core functionality
  • โ€ข Small, focused PRs have a higher chance of being accepted

2 Established Contributors

After several successful PRs and demonstrating understanding of the codebase

  • โ€ข May work on more complex features
  • โ€ข Can contribute to game mechanics and systems
  • โ€ข Trusted with larger changes

3 Core Contributors

Only those with extensive experience with the project

  • โ€ข May modify critical game systems
  • โ€ข Can work on core architecture changes
  • โ€ข Trusted with sensitive parts of the codebase

Repository Activity

Recent Activity

Repository Last Updated July 5, 2025 at 05:00 PM
Last Code Push July 5, 2025 at 11:19 PM
Repository Created December 12, 2024 at 01:27 AM

Found a Bug or Have a Feature Request?

Help improve OpenFront by reporting bugs, requesting features, or suggesting improvements on GitHub.

Please search existing issues before creating a new one to avoid duplicates

Ready to Contribute?

Join the OpenFront development community and help build the future of browser-based strategy gaming. Every contribution, no matter how small, makes a difference!

Explore More Community Platforms

Connect with the OpenFront.io community across multiple platforms