Skip to content
This repository has been archived by the owner on Mar 5, 2023. It is now read-only.

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Muhammad Haseeb authored Jun 25, 2021
1 parent 6420297 commit 25b250b
Showing 1 changed file with 65 additions and 2 deletions.
67 changes: 65 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,65 @@
# StandupMonkey
A self hosted slack bot to conduct standups & generate reports.
<p align="center">
<a href="https://github.com/iam-mhaseeb/StandupMonkey">
<img src="https://user-images.githubusercontent.com/15142776/123471571-6c043280-d60f-11eb-8db3-2f706fe47b4e.png" alt="Standup Monkey" width="200px">
</a>

<h3 align="center">StandupMonkey</h3>

<p align="center">
A self hosted slack bot to conduct standups &amp; generate reports.
<br />
<br />
<a href="https://github.com/iam-mhaseeb/StandupMonkey/issues">Report Bug</a>
·
<a href="https://github.com/iam-mhaseeb/StandupMonkey/issues">Request Feature</a>
</p>
</p>

![Contributors](https://img.shields.io/github/contributors/iam-mhaseeb/StandupMonkey)
![Issues](https://img.shields.io/github/issues-raw/iam-mhaseeb/StandupMonkey)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
![Forks](https://img.shields.io/github/forks/iam-mhaseeb/StandupMonkey?style=social)
![Stars](https://img.shields.io/github/stars/iam-mhaseeb/StandupMonkey?style=social)

Installation
-----------
1. Install already hosted bot (**Use this for only testing purpose**)

<a href="https://slack.com/oauth/v2/authorize?client_id=1679973182834.2145157912624&scope=channels:history,chat:write,im:history,im:read,commands&user_scope="><img alt="Add to Slack" height="40" width="139" src="https://platform.slack-edge.com/img/add_to_slack.png" srcSet="https://platform.slack-edge.com/img/add_to_slack.png 1x, https://platform.slack-edge.com/img/[email protected] 2x" /></a>

2. Deploy on your own server (**Recommended**)
1. Clone this repoistory and deploy on server of your choice
2. Go to https://api.slack.com/apps
4. Select **Create New App**
5. Choose **From an app manifest**
6. Select your workspace
7. Copy yaml from [here](https://github.com/iam-mhaseeb/StandupMonkey/blob/main/manifest/app.yml) paste it in a code editor
8. Replace https://standup-monkey.herokuapp.com with your server base url (example: https://yourwebsite.com)
9. Paste it in opened modal and click next
10. Click create and app will be created in your workspace
11. Go to manage your app screen & select **Basic Information**
12. Navigate to **App Credentials** section
13. Set the following enviornment variables:
* **Client ID as SLACK_CLIENT_ID**
* **Client Secret as SLACK_CLIENT_SECRET**
* **Signing Secret as SIGNING_SECRET**
14. Add your newly added bot to your required channel
15. You standup bot is now ready to use 🎉

Quick start
-----------
1. Go to **StandupMonkey** messages
2. Type **/standup**
![image](https://user-images.githubusercontent.com/15142776/123472160-3ca1f580-d610-11eb-9f1e-16e12e2c4897.png)
3. Fill details in the input boxes and press enter to submit each input
![image](https://user-images.githubusercontent.com/15142776/123472383-88549f00-d610-11eb-9e7c-fa3e176330c5.png)
**Note: Make sure StandupMonkey is added to the channel in which you are trying to post your standup status**
4. StanupMonkey will post submitted standup status to selected channel automatically
![image](https://user-images.githubusercontent.com/15142776/123472559-c0f47880-d610-11eb-8d95-ef60c3f709e5.png)

## Authors

* **Muhammad Haseeb** - *Initial work* - [Muhammad Haseeb](https://github.com/iam-mhaseeb)

## Licensing
The project is [GPL-3.0 License](LICENSE).

0 comments on commit 25b250b

Please sign in to comment.