/thoughts

A simple self-hosted tool for retrospectives

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Thoughts 💭

Thoughts is a simple self-hosted tool for facilitating retrospectives.

  • Simple authentication, enter your name and start using the app
  • Create a retrospective using one of the templates provided or use your own custom columns
  • Add thoughts to the retrospective, only visible to you
  • Group similar thoughts together
  • Vote on thoughts to prioritize them
  • Discuss thoughts with your team
  • Add tasks to document action items

Note

Thoughts has live updates so that you can ensure everyone is on the same page ⚡️

Thoughts

Getting Started

The easiest ways to get started with Thoughts is to use the standalone binary release or the docker image.

Standalone Binary

Go to the releases page and download the latest release for your platform.

./thoughts

Docker Image

docker run -p 3000:3000 -v $PWD/data:/data ghcr.io/ellgreen/thoughts:latest

Want to terminate TLS in the container?

docker run -p 3000:3000 \
  -v $PWD/data:/data \
  -e THOUGHTS_TLS_CERT_PATH="/path/to/your/tls.crt" \
  -e THOUGHTS_TLS_KEY_PATH="/path/to/your/tls.key" \
  ghcr.io/ellgreen/thoughts:latest

Features

GIF Support

To enable support for gifs via Tenor, you will need to set the THOUGHTS_TENOR_API_KEY environment variable.

You can follow the instructions to get an API key here:

https://developers.google.com/tenor/guides/quickstart#setup