You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
4.[Run the app using Docker, Dev Containers, or Manually](#4-run-the-app-locally)
11
+
5.[Populate the database](#5-populate-the-database-and-database-migrations)
12
12
13
13
To test the backend:
14
14
15
-
-Run unit tests
16
-
-Run e2e integration tests from the frontend for full-stack contributions
15
+
6.[Run unit tests](#6-unit-testing)
16
+
7.[Run e2e integration tests from the frontend for full-stack contributions](#7-format-and-linting)
17
17
18
-
## Prerequisites
18
+
-[Git Flow and Deployment](#git-flow-and-deployment)
19
+
-[APIs](#apis)
20
+
21
+
22
+
## 1. Prerequisites
19
23
20
24
- NodeJS v22.x
21
25
- Yarn v1.x
22
26
- Docker and / or PostgreSQL
23
27
24
28
_Recommended Minimum System Requirements: CPU: Quad-core 2.5 GHz (i5/Ryzen 5), Memory: 16 GB RAM, Storage: 512 GB, OS: Linux, macOS, Windows, or WSL2 (latest versions), Internet Connection: For accessing dependencies and external APIs/services._
25
29
26
-
## Configure Environment Variables
30
+
## 2. Configure Environment Variables
27
31
28
32
See [configure-env.md](configure-env.md) for instructions on configuring environment variables.
29
33
30
-
## Install dependencies with yarn
34
+
## 3. Install dependencies with yarn
31
35
32
36
```bash
33
37
yarn
34
38
```
35
39
36
-
## Run the App Locally
40
+
## 4. Run the App Locally
37
41
38
42
There are 3 methods you can use to run Bloom’s backend locally:
39
43
@@ -97,7 +101,13 @@ You should see this in the shell output:
97
101
Listening on localhost:35001, CTRL+C to stop
98
102
```
99
103
100
-
## Unit Testing
104
+
## 5. Populate the Database and Database Migrations
105
+
106
+
Populating your local database with test data is required for running Cypress integration tests and testing Bloom’s full-stack functionality.
107
+
108
+
See the [database-guide.md](database-guide.md) for instructions.
109
+
110
+
## 6. Unit Testing
101
111
102
112
To run all unit tests
103
113
@@ -111,7 +121,7 @@ To have your unit tests running in the background as you change code:
111
121
yarn test:watch
112
122
```
113
123
114
-
## Format and Linting
124
+
## 7. Format and Linting
115
125
116
126
Linting and formatting are provided by [ESLint](https://eslint.org/) and [Prettier](https://prettier.io/). We recommend VSCode users to utilize the workspace settings in [.vscode/settings.json](.vscode/settings.json) and install the extensions in [.vscode/extensions](.vscode/extensions.json) for automated consistency.
117
127
@@ -135,12 +145,6 @@ Run format and fix:
135
145
yarn format
136
146
```
137
147
138
-
# Populate the Database and Database Migrations
139
-
140
-
Populating your local database with test data is required for running Cypress integration tests and testing Bloom’s full-stack functionality.
141
-
142
-
See the [database-guide.md](database-guide.md) for instructions.
143
-
144
148
# Git Flow and Deployment
145
149
146
150
**The develop branch is our source of truth, not main.** Fork from `develop`, create new feature branch, then when your PR is merged, `develop` will automatically merge into the main branch for deployment to production. Keep your branch updated by rebasing and merging feature/bug branches into `develop` as you code.
0 commit comments