Awesome
<div align="center">🦉Owlly
A file-based .env change notifier for your slack team.
<img src="https://user-images.githubusercontent.com/83855174/202204929-9eff7a48-84bc-4673-b721-f3b81403ee83.gif" alt="demo" width="100%" /> </div>Table of Contents
Features
- Auto-sync .env file changes
- Watch multiple .env files
- Provide a clean and intuitive UI
- Auto-post the update to slack channel as attachment
- Basic metadata supported: timestamp, .env directory
- Cross platform supported: Windows, Mac OS(intel, m1 chip)
- Got a cool hand-drawn logo thanks to @HaidiYJ
Install
Stable
Download stable release here. This is the almost same version with the above GIF demonstration(toast notification added)
Latest
Owlly is under active development. If you want to explore the latest feature and changes, follow below install guide.
Clone this repo. Make sure to install all dependencies.
git clone https://github.com/asunlabs/owlly.git
Look over with development mode.
wails dev
Build it with Wails. This will conveniently compile the project based on your OS and architecture.
wails build
Execute binary.
owlly
Prerequisite
Assumption
Owlly will check if below files exist in your project root and sync if exist.
envList = []string{
".env",
".env.test",
".env.development",
".env.production",
".env.dev",
".env.stage",
".env.prod",
".env.local",
".env.development.local",
".env.test.local",
".env.production.local",
}
Owlly ver 0.3.1 is event-based. When form value is submitted in react client side, the value is tossed to go backend by wails. Owlly takes the value and uses for its configuration under the hood.
Slack
In order to use Owlly, you have to
- Create a slack bot here
- Install the bot to your slack workspace
- Issue bot user oauth token and get channel ID to use the bot.
Make sure your bot has proper configuration/privileges to for sending DM. Refer below to set up a permission scope.
Usage
- Run Owlly
./owlly-for-windows.exe
./owlly-for-mac
./owlly-for-mac-m1
- Update .env files as you wish.
FOO="bar"
- Once done, set owlly trigger in your .env. This variable will be a key for Owlly to know if your update is done. So your .env will look like,
AUTHOR="developerasun"
FOO="bar"
# length of OWLLY_DONE > 0 ? send a DM : do nothing
# OWLLY_DONE="true" // add this line when update is done
- Click send button. Check your slack channel if the message is sent. Result will look like below.
Workflows
In Owlly, a several groups of automation is configured.
- auto pull request reviewer
- auto pull request label by branch name
- auto format and lint for go codes
- auto release by push
- auto dependency tracking
- auto staled issue checking
If you add some workflows to owlly, I would suggest to develop it with act to check the workflows locally first and then open a pull request.
Note that the act is based on Docker, meaning you have to run Docker daemon first.
# Run act dry-run
act -n push
act -n pull_request
Contribution
Owlly is a open sourc project. Feel free to open a pull request and suggest changes / improvement.