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 about how to build with XMTP? Ask your question and learn with the community in XMTP Community Forums.
Report a bug using GitHub Issues.
Request a feature using GitHub Issues.
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