56
56
57
57
### Getting started
58
58
59
- You will need your own mySQL and redis databases for backend functions, and Google Cloud project for OAuth .
59
+ You will need your own MySQL database for backend functions.
60
60
61
61
- Fork and clone this repo
62
62
- Add a db_schemas folder in server directory
63
- - Add a .env file to the root directory
64
- - Go to the Google Cloud Platform Console
65
- - Set up OAuth 2.0 credentials as laid out in <a href =" https://support.google.com/cloud/answer/6158849?hl=en " >here</a >. Make sure
66
- your authorized redirect URI in the credentials you create matches the GOOGLE_AUTH_CALLBACK variable below.
67
- - Populate the .env file with the newly created code below:
63
+ - Add a .env file to the root directory with the information below:
68
64
69
65
``` bash
70
- GOOGLE_AUTH_CALLBACK = ' '
71
- USER_DB_URL = [mysql url for storing user data]
72
- DEV_SERVER_ENDPOINT = ' http://localhost:3000'
73
- DEV_CLIENT_ENDPOINT = ' http://localhost:8080'
74
- CLIENT_ENDPOINT = ' http://localhost:3000'
75
- GOOGLE_AUTH_CALLBACK = ' http://localhost:3000/api/oauth/google'
76
- GOOGLE_AUTH_CLIENT_ID = [google auth client id]
77
- GOOGLE_AUTH_CLIENT_SECRET = [google auth client secret]
78
- REDIS_URL = [redis url]
79
- REDIS_PORT = [redis port]
80
- REDIS_PASSWORD = [redis password]
81
- REDIS_SECRET = [redis secret]
82
- ENVIRONMENT = " development"
83
- TOKEN_KEY = [any string]
66
+ # production environment variables
67
+ USER_DB_URL = < MySQL url for storing user data>
68
+ USER_DB_USER = < user string from USER_DB_URL>
69
+ USER_DB_PW = < password string from USER_DB_URL>
70
+ TOKEN_KEY = < any string>
71
+
72
+ # testing environment variables
73
+ # # encoded SSL data required for GitHub Actions
74
+ SSL_KEY = < base64 encoded SSL key (see SSL Configuration)>
75
+ SSL_CERT = < base64 encoded SSL cert>
76
+ # # MySQL and Postgres databases to test remote connection functionality
77
+ MYSQL_TEST_URL = < MySQL url for a test database>
78
+ MYSQL_TEST_USERNAME = < user string from MYSQL_TEST_URL>
79
+ MYSQL_TEST_PW = < password string from MYSQL_TEST_URL>
80
+ PG_TEST_URL = < PostgreSQL url for a test database>
81
+ PG_TEST_USERNAME = < user string from PG_TEST_URL>
82
+ PG_TEST_PW = < password string from PG_TEST_URL>
83
+ # # test user with saved schema to test save/load functionality
84
+ TEST_USER_EMAIL = < email string>
85
+ TEST_USER_PW = < password string>
84
86
```
85
87
86
88
- Run the following below:
@@ -103,9 +105,11 @@ $ npm run dev
103
105
104
106
---
105
107
106
- ### Connecting with remote MySQL
108
+ ### SSL Configuration
107
109
108
- - To connect with the SQL database, we must create and configure SSL certificates.
110
+ To connect with the SQL database, we must create and configure SSL certificates.
111
+
112
+ ### Mac
109
113
110
114
1 . Install mkcert; you can learn more about mkcert [ here] ( https://github.com/FiloSottile/mkcert )
111
115
@@ -119,6 +123,20 @@ npm install -g mkcert
119
123
npm run cert
120
124
```
121
125
126
+ ### Linux
127
+
128
+ 1 . Check mkcert is up to date (v1.5.1 as of publishing)
129
+
130
+ ``` bash
131
+ mkcert --version
132
+ ```
133
+
134
+ 2 . Run the following script
135
+
136
+ ``` bash
137
+ npm run cert:linux
138
+ ```
139
+
122
140
---
123
141
124
142
# How to Use
@@ -190,6 +208,10 @@ npm run cert
190
208
191
209
### Credits/Contributors
192
210
211
+ - Alexander Tu • [ LinkedIn] ( https://www.linkedin.com/in/atu816/ ) • [ Github] ( http://github.com/atu816 )
212
+ - Michael Costello • [ LinkedIn] ( https://www.linkedin.com/in/mcostello-swe/ ) • [ Github] ( https://github.com/neighbor-peace )
213
+ - Steven Geiger • [ LinkedIn] ( https://www.linkedin.com/in/sgeiger9/ ) • [ Github] ( https://github.com/geistnine )
214
+ - Yufa Li • [ LinkedIn] ( https://www.linkedin.com/in/yufa-li/ ) • [ Github] ( https://github.com/01001101CK )
193
215
- Angel Giron • [ LinkedIn] ( https://www.linkedin.com/in/acgiron/ ) • [ Github] ( https://github.com/g94angel )
194
216
- John Paul Adigwu • [ LinkedIn] ( https://www.linkedin.com/in/johnpaul-adigwu/ ) • [ Github] ( https://github.com/engineerous )
195
217
- Kevin Park-Lee • [ LinkedIn] ( https://www.linkedin.com/in/kevin38424/ ) • [ Github] ( https://github.com/kevin38424 )
@@ -203,10 +225,6 @@ npm run cert
203
225
- Kevin Wang • [ LinkedIn] ( https://www.linkedin.com/in/kevin-w-b841b13/ ) • [ Github] ( https://github.com/kwang929 )
204
226
- Kris Magat • [ LinkedIn] ( https://www.linkedin.com/in/kmag/ ) • [ Github] ( https://github.com/KrisMagat )
205
227
- Santiago Gil Maya • [ LinkedIn] ( https://www.linkedin.com/in/santiago-gil-929721121/ ) • [ Github] ( https://github.com/santiago-gil )
206
- - Alexander Tu • [ LinkedIn] ( https://www.linkedin.com/in/atu816/ ) • [ Github] ( http://github.com/atu816 )
207
- - Michael Costello • [ LinkedIn] ( https://www.linkedin.com/in/mcostello-swe/ ) • [ Github] ( https://github.com/neighbor-peace )
208
- - Steven Geiger • [ LinkedIn] ( https://www.linkedin.com/in/sgeiger9/ ) • [ Github] ( https://github.com/geistnine )
209
- - Yufa Li • [ LinkedIn] ( https://www.linkedin.com/in/yufa-li/ ) • [ Github] ( https://github.com/01001101CK )
210
228
211
229
---
212
230
0 commit comments