Contributing to Trench
Trench is an open source project and we welcome contributions from the community.
Developing and deploying the backend locally
We welcome contributions to improve the backend. Before starting, we recommend opening an issue for discussion to ensure your idea aligns with the project’s goals.
Backend Setup Guide
- Fork the repository and clone it to your local machine.
- Navigate to the
apps/trench
directory and copy the.env.example
file to.env
:
-
Make sure you have the following prerequisites installed:
-
Start the local development environment:
- The backend should now be running locally on
http://localhost:4000
. - Create a new branch for your changes.
- Develop your feature or fix and write tests for it. Specifically, writing an end to end test for your feature is highly recommended.
- Ensure all tests pass by running
pnpm test:e2e
(you will need to be running the dev server locally on port 4000 with HTTP for this to work) - Commit your changes and push them to your forked repository.
- Submit a pull request to the main repository.
Improving the Documentation
Good documentation is crucial and requires significant time and effort to create and maintain. All our documentation is written in Markdown to make it easy for contributors.
Documentation Setup Guide
- Fork the repository and clone it to your local machine.
- Go to the
apps/docs
directory. - Make your edits in the relevant
.mdx
files. Optionally, install and start Mintlify to build the documentation site locally. - Commit your changes and push them to your forked repository.
- Submit a pull request to the main repository.
Reporting Issues
You can open an issue to report bugs or suggest new features.
Reporting Bugs
Clearly describe the bug, including steps to reproduce it, what happened, and what you expected to happen. Also, include the browser version, OS, and other relevant software versions (npm, Node.js, etc.) when applicable.
Suggesting Features
Describe the proposed feature, its functionality, why it is useful, and how users should use it. Provide as much information as possible to facilitate discussion, assessment, and implementation. If you are unsure about any aspect of the feature, feel free to leave it open for discussion.
Submitting Pull Requests
Pull requests are highly appreciated. If you plan to propose significant changes, please open an issue for discussion first to ensure your PR will be accepted before you invest time in coding it.
Forking the Repository
- Fork the repository and clone it to your local machine.
- Create a branch for your proposed bug fix or new feature. Avoid working directly on the main branch.
Making Changes
- Implement your bug fix or feature, write tests for it, and ensure all tests pass.
- Commit your changes and push your bug fix/feature branch to your forked repository.
- Submit a pull request to the main branch of the upstream repository (the repository you originally forked).
Was this page helpful?