aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorKaran Jayachandra <mail@karanjayachandra.com>2025-07-25 16:37:37 +0200
committerKaran Jayachandra <mail@karanjayachandra.com>2025-07-25 16:37:37 +0200
commit7e480ec648941355c0373197120e81721bc57dd3 (patch)
tree6ab2b7a9faebc5707df140453cef66d95494ad4a /CONTRIBUTING.md
parentc37b96a254c3a88582e4507ea180d63ce65c9af0 (diff)
parent38f099ae6ec7e7ae7338402a03654ee6378e4274 (diff)
Merge branch 'develop' into 'main'
Develop See merge request KaranJayachandra/match_up!19
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..9c15148
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,34 @@
+# Contributing
+
+To contribute you need to have [git](https://git-scm.com/) and [UV](https://docs.astral.sh/uv/) setup.
+
+## Setup
+
+Set up the repository via a git clone and setup a new branch using the following commands:
+
+```bash
+git clone git@gitlab.com:KaranJayachandra/match_up.git
+cd match_up
+git checkout develop
+git branch <branch-name>
+git checkout <branch-name>
+```
+
+Now we can install the dependencies using:
+
+```bash
+uv sync
+```
+
+A database URI needs to be added to let the application know where to create a test database by creating a `.flaskenv` file in the root directory containing the variable `SQLALCHEMY_DATABASE_URI=sqlite:///app.db`. Now, we need to initialize a database for testing via the following commands:
+
+```bash
+uv run flask init
+uv run flask migrate
+```
+
+We are now ready to run the flask application using:
+
+```bash
+uv run flask run
+```