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
Copy file name to clipboardexpand all lines: README.md
+17-19
Original file line number
Diff line number
Diff line change
@@ -45,7 +45,6 @@ For a more detailed explanation of this project's key concepts and architecture,
45
45
-[Docker](https://www.docker.com/) - Containers for api and db
46
46
-[Heroku](https://heroku.com) - Build, deploy and operate staging and production apps
47
47
-[GitHub Actions](https://github.com/features/actions) - CI pipeline
48
-
- Swagger - API documentation
49
48
50
49
## Local development
51
50
@@ -59,16 +58,22 @@ For a more detailed explanation of this project's key concepts and architecture,
59
58
60
59
**Recommended for Visual Studio & Visual Studio Code users.**
61
60
62
-
This method will automatically install all dependencies and IDE settings in a Dev Container (Docker container) within Visual Studio Code. Simply clone this repo to your computer, open in Visual Studio Code, and select "Re-open in Container" when notified.
61
+
This method will automatically install all dependencies and IDE settings in a Dev Container (Docker container) within Visual Studio Code.
63
62
64
-
After re-opening VS Code in a dev container, develop as you normally would and use the container terminal within VS Code. Next, [configure your environment variables](#configure-environment-variables).
63
+
Directions for running a dev container:
64
+
1. Meet the [system requirements](https://code.visualstudio.com/docs/devcontainers/containers#_system-requirements)
65
+
2. Follow the [installation instructions](https://code.visualstudio.com/docs/devcontainers/containers#_installation)
66
+
3.[Check the installation](https://code.visualstudio.com/docs/devcontainers/tutorial#_check-installation)
67
+
4. After you've verified that the extension is installed and working, click on the "Remote Status" bar icon and select
68
+
"Reopen in Container". From here, the option to "Re-open in Container" should pop up in notifications whenever opening this project in VS.
69
+
5.[Configure your environment variables](#configure-environment-variables) and develop as you normally would.
65
70
66
71
The dev Container is configured in the `.devcontainer` directory:
67
72
68
73
-`docker-compose.yml` file in this directory extends the `docker-compose.yml` in the root directory.
69
74
-`devcontainer.json` configures the integrations with Visual Studio Code, such as the IDE extensions and settings in the `vscode` directory.
70
75
71
-
Read for more detailed instructions: [Visual Studio Code Docs: Developing Inside a Dev Container](https://code.visualstudio.com/docs/devcontainers/containers).
76
+
See [Visual Studio Code Docs: Developing Inside a Dev Container](https://code.visualstudio.com/docs/devcontainers/containers) for more info.
72
77
73
78
### Install dependencies
74
79
@@ -78,18 +83,10 @@ yarn
78
83
79
84
### Configure Environment Variables
80
85
81
-
- If you are an official Chayn volunteer: please get in touch with the team for access to our environment variables.
82
-
83
-
- If you are an open-source contributor: create a new `.env` file and populate it with the following variables.
84
-
85
-
**The Firebase tokens are required for running locally, the Simplybook tokens are required for testing, and all other variables are optional.**
86
-
87
-
You will need to gather your own Firebase tokens. Here are resources to get started:
-[Firebase Docs: Get Started with Fundamentals](https://firebase.google.com/docs/guides)
86
+
Create a new `.env` file and populate it with the variables below. Note that only the Firebase and Simplybook tokens are required.
87
+
To configure the Firebase variables, first [create a Firebase project in the Firebase console](https://firebase.google.com/) (Google account required).
88
+
Next, follow [these directions](https://firebase.google.com/docs/cloud-messaging/auth-server#provide-credentials-manually) to generate a private key file in JSON format.
89
+
These will generate all the required Firebase variables.
93
90
94
91
The Simplybook variables can be mocked data, meaning **you do not need to use real Simplybook variables, simply copy paste the values given below.**
95
92
If you acquire real Simplybook environment variables, use the same format given below.
The project is containerized and can be run solely in docker - both the PostgreSQL database and NestJS app. To run the backend locally, make sure your system has Docker installed - you may need Docker Desktop if using a Mac.
143
+
The project is containerized and can be run solely in docker - both the PostgreSQL database and NestJS app. To run the backend locally, make sure your system has Docker installed - you may need Docker Desktop if using a Mac or Windows.
146
144
147
145
First make sure the docker app is running (just open the app). Then run
148
146
@@ -236,7 +234,7 @@ Workspace settings for VSCode are included for consistent linting and formatting
236
234
237
235
### Seed Local Database
238
236
239
-
If you're a volunteer, add data to your local database by seeding it with a backup file. Please [read our Tech Volunteer Guide](https://www.notion.so/chayn/Tech-volunteer-wiki-5356c7118c134863a2e092e9df6cbc34?pvs=4#0fb25ffde84f4854b2d9730200eee283)for directions on seeding the local database.
237
+
If you're an open-source contributor, add data to your local database by seeding it with a backup file. Please read the [Chayn Tech Wiki Guide](https://www.notion.so/chayn/Tech-volunteer-wiki-5356c7118c134863a2e092e9df6cbc34?pvs=4#0fb25ffde84f4854b2d9730200eee283)to obtain a backup file and follow directions to seed the local database.
240
238
241
239
If you're staff and have access to Heroku, you also have the option to seed the database via the following script. Before you start, make sure:
0 commit comments