Retrospected

Retrospected is a free AI-powered Real-time Agile Retrospective Board for engineering teams.

 

           

This project is both an actual product, and also a technology demo using the latest and greatest JavaScript/TypeScript libraries of the month.

It features the following technologies:

• React 18
• React Hooks
• React Router 6
• TypeScript 4.9
• Recoil.js, as the global state management library
• Socket IO
• Vite, as the bundler
• MUI 5 for our components (previously known as Material-UI)
• Material UI design
• Emotion
• Multilingual / Internationalization
• Postgres
• Node 18 (LTS)
• Passport for seamless OAuth authentication with:
• Google
• Twitter
• GitHub
• Slack
• Microsoft
• Okta
• Giphy because adding a bit of fun to your retro can't hurt!
• React Beautiful DND to allow re-ordering and grouping by drag-and-drop
• Vitest, for Unit Testing
• React Testing Library, for Integration Tests
• Yarn, replacing NPM
• Docker, for easy deployment
• Kubernetes, to scale Retrospected for its 10M+ users (not)
• GitHub Actions, for Continuous Integration and Deployment (CI/CD)
• Multi-Architecture, for automatic compatibility with ARM-based servers
• Stripe, for our payment solution
• Docusaurus, for our documentation
• NextJS, for our landing page
• ChatGPT, powering our AI agile coach
• Biome, for linting and formatting, all in one beautiful package

Previous versions featured the following libraries:

• ~~Webpack 5 (See older versions for Webpack 1, 2 and 3)~~
• ~~Create React App 5~~
• ~~Jest for Unit Testing~~
• ~~Redux~~
• ~~CSS Modules~~
• ~~redux-saga~~
• ~~reselect~~
• ~~ESLint for JS and JSX~~

Documentation 📖

You can browse the documentation here.

Using Retrospected 🚀

You have two ways of running Retrospected:

• Using the public version, at www.retrospected.com
• Host Retrospected on your premises

Want to host Retrospected on your premises? 🖥

You can start an instance of Retrospected in 5 minutes by following the quick-start guide.

This will run a demo version, which you can turn into a fully licenced version by purchasing a Self Hosted licence.

Versions History

Version 5.5.2

• Fix integration tests by adding a health check so that the frontend does not start before the backend is ready
• Remove Trivy from the CI pipeline, as it was just not working at all

Version 5.5.1

• Hardcode a licence for the Ministère de l'intérieur (France) for their self-hosted instance

Version 5.5.0

• Migrate from ESLint and Pretter to Biome, a single tool for linting, formatting and more
• Upgrade dependencies across the board
• Fix an issue with running the backend in development mode with ts-node and recent versions of Node

Version 5.4.1

• Add the ability to remove the Cookie Banner (GDPR) on Self-Hosted instances (which is now the case by default)
• Upgrade dependencies (frontend)

Version 5.4.0

• Add the concept of a moderator, so the person creating the retro is not necessarily the person moderating it.
• Upgrade the database to Postgres 16 (latest version)
• Allow finer-grained timers.
• Fix an issue with the left-hand-side panel layout (👏 Thanks to @ruandev for the fix)
• SEO optimizations

Version 5.3.1 (hotfix)

• 🐛 Adding a group was not working in the previous version. This is now fixed.

Version 5.3.0

• [⭐️ Self-Hosting] new features:
• Option to disable data deletion (GDPR)
• Option to disable "Show Author" globally
• New retrospective options:
• Option to restrict editing the title of a session to the moderator
• Option to restrict ordering and grouping to the moderator
• When accessing a private session that you don't have access to, it will now show the name of the moderator.
• Search functionality has been improved: it will now only show matching cards
• 🐛 Bug fix: when there are too many users connected, the "I'm ready button" would become hidden. This is now fixed.
• The Agile Coach is now using Chat GPT 4, which is much more powerful
• A new explanatory video has been added to the marketing website, and the app itself.
• ⏫ Upgrading dependencies

Version 5.2.2 (hotfix)

• Improving documentation

Version 5.2.1 (hotfix)

• Header logo bug fix

Version 5.2.0

• [⭐️ Self-Hosting] Adding white-labelling customisation options to Self-Hosted instances
• New page explaining what Self-Hosted is and what it can do for you
• New callback button on the marketing website

Version 5.1.2 (hotfix)

• Fix odd bug crashing the side-panel in certain circumstances

Version 5.1.1

• Add blog pages to the marketing website
• Rewording on the marketing website
• Fix an issue on the marketing website where links were not working
• Add a warning on the app when a user has a pro account but did not add members to their account
• ⏫ Upgrading dependencies

Version 5.1.0

• [⭐️ Pro Feature] 🤖 AI Coach, powered by Chat GPT. Limited access to non-paid users.
• Improve the login workflow
• Improve the template selection
• Improve the home page, with search on past retrospectives and nicer button
• Allow a user to convert their Anonymous account to a regular account and migrate their data
• Bug fix: fix bug where multiple demos were created

Version 5.0.3

• 🇩🇪 Adding the German version of our marketing website
• Self-Hosted: Improve licence checking to avoid being blocking when internet is not available
• Better support for AD campaigns
• Redirect regional TLDs (.de, .fr) to .com

Version 5.0.2

• Simplify management of environment variables on the frontend
• Add an error 404 page on the marketing site
• Add Ad-Words tracking on the landing page

Version 5.0.1

• Add Google Ad-Words tracking on the frontend
• Fix self-hosted licence checking URL

Version 5.0.0

• 👩‍💻 Brand new landing page, built with NextJS, separated from the main app. The app is now available at https://app.retrospected.com and the landing page at https://www.retrospected.com.
• 🇫🇷 / 🇬🇧 Multilingual support for this new landing age (English and French for now), with auto-detection of the user's language.
• 🚀 Migration from CRA (create-react-app) to Vite, which is much faster and more flexible.
• 💯 Migration to Google Analytics 4
• 🏂 Adding a demo mode: one-click to create a demo session, with a demo account.
• 🖥️ Improved support for self-hosted licence generation

Version 4.19.3 (hotfix)

• Fix Pro account list

Version 4.19.2

• Migration to Google Analytics V4

Version 4.19.1

• Hotfix: Issue with password account creation

Version 4.19.0

• Feature: Adding the ability to set a timer for a session. This is optional and can be enabled in the settings. (👏 Thanks to @Xyaren for the idea)
• Feature: Confirm before deleting a post. Avoids accidental deletion of posts. (👏 Thanks to @vadamovsky for the idea)
• Feature: Allow users to cancel their votes on a specific ticket. This feature can be disabled in the settings. (👏 Thanks to @Xyaren for the idea)
• Feature: Self-Hosted only: Display the number of logged users (👏 Thanks to @dayByte for the idea)
• Upgrade to the latest version of TypeORM
• Convert all backend code to ESM
• 🇩🇪 German language updates (👏 Thanks to @dayByte for his contribution)

Version 4.18.1 (hotfix)

• Reinstates the Enter icon on board input on mobiles (👏 Thanks to Hans K. for the idea)

Version 4.18.0

• Self-Hosted: Adding the ability to merge users (migrating their data into another user). This is only available for self-hosted instances, through the Administration panel (👏 Thanks to Frank Becker for the idea)
• ⏫ Upgrade vulnerable dependencies (thanks to dependabot)
• Fix issues found by code scanning (CodeQL)

Version 4.17.0

• Adding the ability to set administrators for a Pro subscription. An administrator can add and remove users from the Pro subscription, and be independent from the owner (who manages payments). Useful for resellers.
• Display the owner of the subscription clearly on the Account Page
• Upgrading GitHub Actions
• ⏫ Upgrading dependencies

Version 4.16.3

• Exposing "tenant", "authorization url" and "token url" for Microsoft OAuth. (👏 Thanks to Frank Becker for the idea)
• 🇩🇪 German language improvements (👏 Thanks @Tobias G for the PR!)
• ⏫ Upgrading dependencies

Version 4.16.2

• Fixed a bug where sessions a user participated in did not show up on their homepage. (👏 Thanks a bunch to Frank Becker for reporting the issue and helping find the problem)

Version 4.16.1

• Fixed a bug where sessions could not be deleted when there was any chat messages (👏 Thanks Florin Bicher for the report)
• Update icon
• Better Slack integration

Version 4.16.0

• Complete overhaul of the translations. Switching to i18next. Translated all languages using Machine Learning (via Crowdin)
• Added translations for the Ukrainian language, and a link to provide help for Ukraine 🇺🇦
• Fix the empty file download when logging using Google OAuth
• Upgrade the documentation to the latest version of Docusaurus
• Add more integration tests, covering password accounts and account deletion
• Added the language picker in the account page, in addition to the side panel

Version 4.15.0

• Self-Hosting: Improve Admin dashboard for Self-Hosted, allowing the admin to add and delete users
• Self-Hosting: Add an option to allow self-signed certificates for the SMTP server, for sending emails
• Fix GDPR account deletion, which did not work when the user had any chat messages
• Upgrade React typings to v18
• ⏫ Upgrading all frontend dependencies

Version 4.14.1 (hotfix)

• Remove CSRF code, causing random issues

Version 4.14.0

• Upgrade to React 18
• Replace icons by emoji for columns headers (fully customisable)
• Self-Hosting: Adding SMTP support for self-hosting, in addition to SendGrid. 👏 Thanks @dayByte for the idea. (#365).
• Self-Hosting: Simplification of SendGrid setup, by removing the need of creating email templates. They are now hardcoded.
• Self-Hosting: Improving email templates
• Improving Text and Markdown exports on Summary Mode. 👏 Thanks Jakob J for the idea. (#384).

Version 4.13.0

• Adding the option of paying for Retrospected Pro annually, getting one month free in the process
• Update prices, especially for USD
• Make the integration tests less brittle by using specific attributes
• Upgrade (finally!) to React-Router v6.
• Self-Hosting: Allow an administrator to disable Anonymous Logins (to force users to use regular accounts).

Version 4.12.1 (hotfix)

• Adding users to a Pro Team subscription was