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 Statistics
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
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
Join the Community
Request to join the development Discord server to connect with other contributors and get guidance.
Fork & Clone
Fork the repository on GitHub and clone it to your local machine:
git clone https://github.com/YOUR_USERNAME/OpenFrontIO.git
Install Dependencies
Install the required dependencies:
npm install
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.
Top Contributors
Meet the amazing developers who have contributed to OpenFront.io. Their dedication and hard work make this open source project possible.
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
andnpm 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
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