If you're seeing this document, you are an early contributor to the development and success of XMTP. Your questions, feedback, suggestions, and code contributions are welcome!
Have a question? You are welcome to ask it in Q&A discussions.
Report bugs as GitHub Issues. Please confirm that there isn't an existing open issue about the bug and include detailed steps to reproduce the bug.
Submit feature requests as GitHub Issues. Please confirm that there isn't an existing open issue requesting the feature. Describe the use cases this feature unlocks so the issue can be investigated and prioritized.
PRs are encouraged, but consider starting with a feature request to temperature-check first. If the PR involves a major change to the protocol, the work should be fleshed out as an XMTP Improvement Proposal before work begins.
We do not accept pull requests that are generated entirely or primarily by AI/LLM tools (e.g., GitHub Copilot, ChatGPT, Claude). This includes:
- Automated typo fixes or formatting changes
- Generic code improvements without context
- Mass automated updates or refactoring
Pull requests that appear to be AI-generated without meaningful human oversight will be closed without review. We value human-driven, thoughtful contributions that demonstrate an understanding of the codebase and project goals.
Caution
To protect project quality and maintain contributor trust, we will restrict access for users who continue to submit AI-generated pull requests.
If you use AI tools to assist your development process, please:
- Thoroughly review and understand all generated code
- Provide detailed PR descriptions explaining your changes and reasoning
- Be prepared to discuss your implementation decisions and how they align with the project goals
Please make sure you have Docker running locally. Once you do, you can run the following command to start a local test server:
script/local