Skip to content

Commit ffd8ab8

Browse files
committed
feat(README): Updated to include that this project is now sponsored by Digital Ocean and to include better docs about local development and how it is hosted
1 parent af14ebb commit ffd8ab8

File tree

3 files changed

+76
-33
lines changed

3 files changed

+76
-33
lines changed

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2017 Bex Warner
3+
Copyright (c) 2023 Andrew Stilliard
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 75 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,13 @@ Also when viewing all Pull Requests, you'll see the green tick when all complete
4444

4545
Find out more about GitHub task lists: https://help.github.com/en/articles/about-task-lists
4646

47+
<br>
48+
<a href="https://m.do.co/c/60c76a17a70d">
49+
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg" alt="Powered By DO" width="201px">
50+
</a>
51+
52+
<small>This project is supported by & hosted on Digital Ocean, thanks!</small>
53+
4754
## Docs
4855

4956
Install & add to the repos you want.
@@ -63,47 +70,87 @@ This was inspired by [another project here](https://github.com/Shopify/task-list
6370

6471
Tasks that contain "OPTIONAL" in all caps are also skipped unless checked, they are also added to an "(+X optional)" text in the check. This is useful for tasks that are not required to be completed before the PR can be merged.
6572

66-
## TODO
73+
## Contributing / Development
6774

68-
- [x] ~~unit tests & travis CI~~
69-
- [ ] Submit to https://github.com/probot/probot.github.io/blob/master/.github/app-review-process.md
70-
- [ ] Add config to allow changing from in_progress to completed but with a failure or neutral conclsion if needed -> https://probot.github.io/api/latest/classes/context.html#config
71-
- [ ] Finish docs, e.g. about using a .github/task-list.yml for above
75+
Code previous ran on Glitch, now it's hosted on Digital Ocean.
76+
Hosting is via multiple droplets, one configured as a load balancer & then additional worker nodes/droplets for the actual checks to run on.
7277

73-
## Contributing
78+
*For previous glitch deployments, on the glitch page, click tools > console and then run `git pull origin master && refresh`.
79+
Permission changes would need to be changed in the app on github.*
7480

75-
For now, on Glitch you can click to "remix to edit" and then work on your own forked version.
76-
Then if you have ideas to bring over, you can submit an issue to discuss them or a pull request with the code changes.
77-
Thank you.
81+
### Local development
7882

79-
You can also help support the hosting and development of this project with coffee power:
80-
<a href="https://www.buymeacoffee.com/stilliard" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" style="height: 51px !important;width: 217px !important;" ></a>
83+
Using node v18+ & npm 10+ (older versions may also work, your mileage may vary).
84+
85+
Local development can be done by cloning this repo:
86+
```bash
87+
git clone https://github.com/stilliard/github-task-list-completed.git
88+
cd github-task-list-completed
89+
```
90+
91+
Setup up an App inside GitHub:
92+
https://github.com/settings/apps/
93+
94+
Install & run:
95+
96+
```bash
97+
npm install
98+
npm run dev
99+
```
100+
101+
Load up http://localhost:3000/probot and follow intructions to set up the app.
102+
On first run, it will create your `.env` with an initial `WEBHOOK_PROXY_URL=xxxxx`.
103+
After following the set up, make sure you have `APP_ID`, `PRIVATE_KEY`, `WEBHOOK_SECRET` all set.
104+
You can change the port it runs on with `PORT=3001` for example and set a `NODE_ENV=production` for production logs, [more details about logs here](https://probot.github.io/docs/logging/).
105+
106+
<a href="https://probot.github.io/docs/">
107+
View full Probot docs here.
108+
<br>
109+
<img src="https://probot.github.io/assets/img/logo.png" width="80">
110+
</a>
111+
112+
<br>
113+
114+
Testing:
115+
```bash
116+
npm test
117+
```
118+
119+
For production:
120+
```bash
121+
npm install --omit=dev
122+
npm start
123+
```
124+
125+
Instead of `npm start`, typically in production you'll use a [service file to run via systemd](https://www.freedesktop.org/software/systemd/man/latest/systemd.syntax.html) or similar.
126+
e.g.
127+
```systemd
128+
[Service]
129+
ExecStart=npm start
130+
WorkingDirectory=/srv/github-task-list-completed
131+
Restart=always
81132
82-
## Development for main repo
133+
[Install]
134+
WantedBy=multi-user.target
135+
```
136+
137+
You can also help support the hosting and development of this project with coffee power:
83138

84-
Code previous ran on Glitch, now it's self hosted.
85-
86-
For glitch deployments, on the glitch page, click tools > console and then run `git pull origin master && refresh`.
87-
Permission changes would need to be changed in the app on github.
139+
<a href="https://www.buymeacoffee.com/stilliard" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" style="height: 51px !important;width: 217px !important;" ></a>
88140

89141
## Security
90142

91-
The code is all here to see & available on the Glitch link below which is also where the service runs.
92-
No data about your user or repo is logged.
143+
All code is Open source, [MIT license](./LICENSE). Production checks currently log repo name & PR ID for debug purposes only and logs are removed after a max of 7 days.
144+
No logs are recorded about your repos themselves nor the pull request contents.
145+
146+
Hosted check is on DO's [SFO3](https://www.digitalocean.com/blog/introducing-a-new-datacenter-in-the-san-francisco-region-sfo3).
93147

94148
If you discover a security issue please email it to myself at [email protected] and I will get back to you asap. For all other issues or help you can create an issue on this project - Thank you.
95149

96150
## Credits
151+
97152
- [Probot](https://github.com/probot/probot) - Used to build this project
98-
- [Glitch](https://glitch.com/) - Used as an online editor & to host the service
153+
- [Glitch](https://glitch.com/) - Previously used to start this project
99154
- [WIP](https://github.com/wip/app) - Inspiration for this project
100155
- [Juliia Osadcha / iconfinder](https://www.iconfinder.com/icons/1790658/checklist_checkmark_clipboard_document_list_tracklist_icon) Icon used for this project
101-
102-
#### About Glitch
103-
104-
This repo was started on Glitch: https://glitch.com/edit/#!/task-list-completed
105-
106-
**Glitch** is the friendly commmunity where you'll build the app of your dreams. Glitch lets you instantly create, remix, edit, and host an app, bot or site, and you can invite collaborators or helpers to simultaneously edit code with you.
107-
108-
Find out more [about Glitch](https://glitch.com/about).
109-
\ ゜o゜)ノ
156+
- [DigitalOcean](https://m.do.co/c/60c76a17a70d) - Hosting of the live app check

package.json

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,5 @@
2121
"devDependencies": {
2222
"jest": "^29.7.0",
2323
"smee-client": "1.2"
24-
},
25-
"engines": {
26-
"node": "8.9",
27-
"npm": "5.6"
2824
}
2925
}

0 commit comments

Comments
 (0)