First off, thank you for taking the time to contribute to Bolt! Whether you're here to fix a bug, improve documentation, or build a new feature, we welcome your support.
This guide will help you get started with contributing to our projects.
Bolt is composed of several components. Please make sure you're working in the correct repository:
bolt-server: Core server software and sandbox runtimebolt-cli: Command-line interfacebolt-docs: Documentation
Create a fork of the repository you want to contribute to, and clone it locally.
git clone https://github.com/YOUR_USERNAME/bolt-server.git
cd bolt-serverUse a descriptive name that explains your change.
git checkout -b fix/memory-leak-in-sandbox- Follow the project's coding conventions
- Write clear, concise commit messages
- If it's a bugfix, add a test if possible
- If it's a feature, document it clearly
Ensure all tests pass before submitting a pull request. If you're adding a new feature, include tests for it.
# Example (for Python)
pytest tests/Go to your fork on GitHub and click "New Pull Request".
- Describe what you’ve changed and why
- Reference any related issues (e.g.
Closes #42) - If it’s a work-in-progress, label it
[WIP]
Each repo may have its own standards (see the repo’s README or CONTRIBUTING.md), but in general:
-
Languages: Python (CLI & Server)
-
Style Guides:
- Python: PEP8
We love documentation updates! You can:
- Fix typos or outdated content
- Write usage guides, examples, or tutorials
- Improve inline code comments
Documentation lives in:
bolt-docsREADME.mdordocs/folders in each repo
If you encounter a bug or have a feature request:
- Use the issue templates in the appropriate repositories.
- Include steps to reproduce, logs, screenshots, or error messages
- For security issues, please do not open a public issue. Email us at me@proplayer919.dev instead.
- Ask questions or get help in Discussions
- Be respectful — follow our Code of Conduct
- All tests pass
- Code follows style guidelines
- Docs updated (if applicable)
- PR description is clear and linked to issues
By contributing, you agree that your contributions will be licensed under the same license as the project: MIT
Thank you again for helping make Bolt better! ⚡