Skip to content

Commit 35ab6bf

Browse files
update readme
1 parent c238e82 commit 35ab6bf

File tree

1 file changed

+44
-26
lines changed

1 file changed

+44
-26
lines changed

README.md

Lines changed: 44 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -56,31 +56,33 @@
5656

5757
### Getting started
5858

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.
6060

6161
- Fork and clone this repo
6262
- 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:
6864

6965
```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>
8486
```
8587

8688
- Run the following below:
@@ -103,9 +105,11 @@ $ npm run dev
103105

104106
---
105107

106-
### Connecting with remote MySQL
108+
### SSL Configuration
107109

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
109113

110114
1. Install mkcert; you can learn more about mkcert [here](https://github.com/FiloSottile/mkcert)
111115

@@ -119,6 +123,20 @@ npm install -g mkcert
119123
npm run cert
120124
```
121125

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+
122140
---
123141

124142
# How to Use
@@ -190,6 +208,10 @@ npm run cert
190208

191209
### Credits/Contributors
192210

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)
193215
- Angel Giron • [LinkedIn](https://www.linkedin.com/in/acgiron/)[Github](https://github.com/g94angel)
194216
- John Paul Adigwu • [LinkedIn](https://www.linkedin.com/in/johnpaul-adigwu/)[Github](https://github.com/engineerous)
195217
- Kevin Park-Lee • [LinkedIn](https://www.linkedin.com/in/kevin38424/)[Github](https://github.com/kevin38424)
@@ -203,10 +225,6 @@ npm run cert
203225
- Kevin Wang • [LinkedIn](https://www.linkedin.com/in/kevin-w-b841b13/)[Github](https://github.com/kwang929)
204226
- Kris Magat • [LinkedIn](https://www.linkedin.com/in/kmag/)[Github](https://github.com/KrisMagat)
205227
- 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)
210228

211229
---
212230

0 commit comments

Comments
 (0)