create development guide

remove deps badge

correct mongo connection string and driver update

seed data for developer environment, database as docker image
This commit is contained in:
2025-11-20 09:48:56 +01:00
committed by Owen Rees
parent 28f3bf69c6
commit 67e97b6ca0
11 changed files with 26142 additions and 43 deletions
+29
View File
@@ -0,0 +1,29 @@
# Contributing
When contributing to this repository, please first discuss the change you wish to make via a GitHub issue.
## Development Environment Setup
### Prerequisites
- [Yarn](https://classic.yarnpkg.com/lang/en/docs/install/#debian-stable)
- [Docker](https://docs.docker.com/engine/install/)
### Setup
1. Fork the repository
2. Clone your fork locally
3. Run `yarn` to install dependencies
4. Run `docker-compose up` to start the MongoDB database and seed it with test data
5. Run `yarn dev` to start the development server
The test data is not persisted between restarts. Create a Docker volume if you wish for this to be the case.
### Branching
- We use the [GitHub Flow](https://www.gitkraken.com/learn/git/best-practices/git-branch-strategy#github-flow-considerations) branching strategy.
- Use `feature/feature-name` as your branch name.
- Non-feature branches are allowed, but please give a clear name to your branch such as `hotfix/fix-bug`
## Pull Request Process
1. Squash all your commits into a single commit before pushing your branch
2. Give a clear overview of your changes in the commit message
3. When opening a PR, give a clear overview of what your changes are and why
4. Wait for review and approval