Skip to content

Commit 451fa32

Browse files
Add README (#65)
Co-authored-by: LonMcGregor <3817332+LonMcGregor@users.noreply.github.com>
1 parent de62867 commit 451fa32

1 file changed

Lines changed: 35 additions & 0 deletions

File tree

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# trainee-tracker
2+
3+
A website for tracking trainee progress, which also contains a grab-bag of tools which re-use code and auth.
4+
5+
We hope to replace all of this functionality with a well built system, but for now, it glues together different data sources conveniently.
6+
7+
## Local development
8+
9+
To develop locally, you need a few pieces, which you can configure in a `.env` file:
10+
11+
### Local config
12+
13+
You probably want to set exactly this: `CYF_TRAINEE_TRACKER_PUBLIC_BASE_URL=http://localhost:3000`
14+
15+
### GitHub OAuth app
16+
17+
Set up an OAuth application in https://github.com/settings/developers and set the following env vars:
18+
19+
* `CYF_TRAINEE_TRACKER_GITHUB_CLIENT_ID`
20+
* `CYF_TRAINEE_TRACKER_GITHUB_CLIENT_SECRET`
21+
22+
### Google OAuth app
23+
24+
Set up an OAuth application in a project in https://console.cloud.google.com/auth/clients/create and set the following env vars:
25+
26+
* `CYF_TRAINEE_TRACKER_GOOGLE_APIS_CLIENT_ID`
27+
* `CYF_TRAINEE_TRACKER_GOOGLE_APIS_CLIENT_SECRET`
28+
29+
### Slack (optional)
30+
31+
If you want Slack integration (you probably don't), make a Slack App and set `CYF_TRAINEE_TRACKER_SLACK_CLIENT_SECRET=`.
32+
33+
### PR validator bot (optional)
34+
To allow the PR validator to test things without setting up a github app for the whole tracker, create a token with with pull request permissions and set the following env var:
35+
* `GH_TOKEN=`

0 commit comments

Comments
 (0)