Retro - Make Retrospectives Great Again
What is Retro?
Retro is a tool that you can use for retrospectives and planning poker sessions. The goal of Retro is to aid teams in remote retrospectives.
At work, we were using third party retrospective tools, which meant we couldn't express ourselves freely because of privacy reasons. Retro provides an open-source solution, where you can host the app on your own servers, so you can discuss freely again, since you own the data.
Example - Retrospective
Example - Planning Poker
Requirements
- Latest Node.js LTS version
- NPM version >= 7
Usage Locally
Install dependencies
$ cd backend && npm i && cd ..
$ cd frontend && npm i && cd ..
Run servers
$ cd backend && npm run start:dev && cd ..
$ cd frontend && npm run start && cd ..
Branching
- The
master
branch is the latest development stage - Stable releases are tagged with their respective version number
- There might be feature branches that contain new experimental stuff
Deployment Examples
PM2
- Install PM2 on your server
- Clone this project on your server
- Install the dependencies by running
npm i
onbackend
andfrontend
- Check if the proxy settings are correct
- Check
backend/src/config/index.ts
- Check
frontend/src/setupProxy.js
- Check
frontend/src/utils/index.ts
- Check
- Provide an
.env.production.local
file inside offrontend
# Example REACT_APP_PROD_URL=http://mydomain.com REACT_APP_PROD_PORT=80
- Build the frontend by running
npm run deploy
- Go to the
backend
folder and runpm2 start processes.json
Docker
- There is a
Dockerfile
on the project root which builds everything and runs the server - You might want to define your own restart policy then
- The server runs without process managers. You can read here why.
Contributing
- This project uses
- Prettier
- LTS version of Node.js
- Conventional Commits
- You can also develop with the provided Docker containers!
- on Linux, make sure to set an environment variable, since
host.docker.internal
is not working:export DOCKER_HOST_IP=$(docker network inspect bridge --format='{{(index .IPAM.Config 0).Gateway}}')
- on Linux, make sure to set an environment variable, since
Project State
- You can always watch the current state of the project at Trello
✨
Contributors Thanks goes to these wonderful people (emoji key):
Adrian Endrich |
Claas Busemann |
PaulaBre |
Tobias |
ravensinth |
Marius Wichtner |
Yadullah Duman |
Dominik Schumann |
This project follows the all-contributors specification. Contributions of any kind welcome!