Contribution guide
This guide explains how to contribute to AtlasOS. We welcome all contributions.
Our contribution platform
Atlas uses GitHub for everything. This documentation doesn’t cover GitHub or Git; if you’re new to them, see the GitHub quick-start guide first.
Read the Code of Conduct before contributing.
Areas of contribution
Atlas Playbook
Core AtlasOS source code and scripts
Documentation
Help improve the docs
Atlas Toolbox
Toolbox utility development
Testing Guide
What to test and how
Report Issues
How to report bugs
How to make changes
Unsure if people will like your change?
Propose it in Discord or GitHub issues first. Mistakes are fine—reviewers will give feedback in pull requests. You don’t need to get everything right on the first try.
Follow these steps to contribute:
- Fork or branch – Create a fork (external contributors) or branch (team members)
- Make your changes – Implement your improvements or fixes
- Submit a pull request – Open a PR against the primary branch
- Wait for reviews – At least two reviews (team members need one)
- Merge – Once approved, your PR is squash-merged into one commit
Info
Team members may skip pull requests for uncontroversial, well-tested changes that don’t require review.
Formatting
Before submitting a pull request:
- Match the repository’s formatting
- Check grammar and fix mistakes
- For YAML changes, run a linter to verify validity
Commit signature verification
Set up commit signature verification so your commits show as Verified. See this guide for verified commits.
Conventional commits
Use Conventional Commits in Atlas repositories for consistent, descriptive commit messages.
Example: feat: ✨ add fAllowFullControl