Thank you for your interest in contributing to libsql! We welcome contributions from the community to make this project better.
Before you start, please take a moment to review the guidelines outlined below.
Please note that we have a Code of Conduct in place to ensure a positive and inclusive environment for everyone involved.
Getting Started
Fork the repository. Clone your forked repository to your local machine. Create a new branch for your feature or bug fix: git checkout -b feature-name. Make your changes and test thoroughly. Commit your changes with descriptive commit messages. Push your changes to your forked repository: git push origin feature-name. Submit a pull request to the main branch of the original repository. Contribution Guidelines
All contributions should be well-documented and follow the existing code style. Include tests for any new functionality or bug fixes. Update documentation as necessary, including any relevant README or usage guides. Maintain backward compatibility whenever possible. Follow the Git commit message guidelines for consistent commit messages. Review the existing issues and pull requests to avoid duplicating efforts. Pull Request Process
Ensure that your pull request addresses a specific issue. If there isn't an issue, consider creating one first. Clearly describe the problem or feature in your pull request and reference the relevant issue. Provide steps to reproduce and test your changes if applicable. Ensure that your branch is up-to-date with the latest changes from the main branch. All checks (tests, formatting, etc.) must pass before your pull request can be merged. After addressing review comments, your pull request will be merged by a project maintainer. Documentation
Help us improve the project's documentation by fixing typos, clarifying language, or adding missing information. Documentation improvements can be submitted as pull requests.
Reporting Issues
If you encounter a bug or have a suggestion for the project, please open an issue using the provided issue template. Include as much detail as possible to help us understand and address the problem.
Getting Help
If you need assistance, have questions, or want to discuss ideas, you can:
Join our Discord server and chat with the community. Mention @maintainer in your issue or pull request for a faster response from project maintainers. We appreciate your time and effort in contributing to libsql!