This is a Retrospective Idea board, powering retrospected.com.
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.6
- Recoil.js, as the global state management library
- Socket IO
- Webpack 5 (See older versions for Webpack 1, 2 and 3)
- Create React App 5
- MUI 5 for our components (previously known as Material-UI)
- Material UI design
- Emotion
- Multilingual / Internationalization
- Postgres
- Node 16
- Passport for seamless OAuth authentication with:
- 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
- Jest 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
Previous versions, up to v1.0.1 featured the following libraries:
ReduxCSS Modulesredux-sagareselectESLint for JS and JSX
You can browse the documentation here.
You have two ways of running Retrospected:
- Using the public version, at www.retrospected.com
- 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.
- 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)
- 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
- 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
- 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)
- 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
- 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
- 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
- Remove CSRF code, causing random issues
- 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).
- 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).
- Adding users to a Pro Team subscription wasn't working anymore, because of Webpack 5.
- Changing naming convention for the database. All fields and tables are now
snake_case. - Simplified the configuration of TypeORM, removed the generation of
ormconfig.json. - Added Integration tests using Cypress to catch Docker-specific errors and have some basic smoke tests.
- Upgrade to
react-scripts(Create React App) 5.0.0 - Upgrade jQuery (for the marketing / home page), to 3.6.0 for security reasons
- ⏫ Upgrading dependencies
- Making secure cookies an optional setting, as they won't work unless it is hosted on HTTPS.
- Fixing a migration issue when installing from scratch
- Adding hardcoded licence for a specific self-hosted client.
- Encrypt chat messages on encrypted sessions
- Ensure long chat messages are displayed across multiple lines
- Reverting the migration from react-scripts (create-react-app) 5.0.0 to 4.0.3. The new version includes Webpack 5, which causes issues with polyfills. The issue should be fixed in 5.0.1 which is not available yet.
- Adding a chat functionality. Send messages to your colleagues without having to use Slack or any other external tool!
- Add the author (when the "Show Author" option is enabled) in the summary panel. 👏 Thanks @hmlkao for the idea. (#336).
- Deprecate Yarn Workspaces to limit dependency sharing
- ⏫ Upgrade most dependencies for security reasons
- Upgrade Nginx image to fix security issues
- Force secure cookies on production
- Add Trivy vulnerability scanner on CI
- Add better GDPR compliance, with the right to be forgotten: allows a user to delete all of their data
- Add the ability for users to signal if they are done with their posts, to help the moderator
- ⏫ Upgrading dependencies
- Brand new documentation website.
- Migrate all docker images from
antoinejaussoin/retro-board-*toretrospected/*. - Allowing Self-Hosted instances to use SendGrid for email recovery
- 🐛 The Unlimited subscription domain check was not accepting valid domains such as
.venturesor.agency.
- Upgrade to MUI 5.0 (ex Material UI)
- Migration from Styled Components to Emotion (for compatibility reasons with MUI)
- Add hard-coded self-hosting licence mechanism for companies with restricted internet access
- ⏫ Upgrading dependencies
- Replacing Google OAuth passport library, to try and reduce Google OAuth errors on production
- Added a script to make bumping versions easier
- ⏫ Upgrading dependencies
- 🐛 Fixed a bug highlighted by Sentry, where anonymous account without a password would trigger an exception.
- Account Federation: all accounts with the same email address are now a unique account (sharing sessions, etc.). If you owned multiple accounts with the same email address (for instance one via Google OAuth and another via GitHub), they will be merged into a single account.
- CSRF protection
- Significant performance improvements on retrieving past sessions (10x to 100x)
- Add the ability for anonymous users to delete the boards they created under certain conditions (#229).
- ⏫ Upgrading dependencies
- Fixing a typo. 👏 Thanks Chad S.! (#296)
- Support OKTA for authentication
- Speeding up the migration on production (using transpiled JavaScript instead of TypeScript via ts-node)
- Making email checks for Pro Team subscriptions case-insensitive. 👏 Thanks Nico! (#287)
- Adding the ability to self-host Retrospected in a very easy way.
- Change the default order for new posts. New posts are now (by default) appearing at the top of the column. 👏 Thanks @konrad44 for the idea. (#272)
- Upgrade containers from Node 15 to Node 16
- Spelling fixes on home page cards
- ⏫ Upgrading dependencies
- 🐛 Fixed a bug where the export button on the summary page was hidden by the participants bar. 👏 Thanks @hieuwu for pointing this out. (#262)
- Added the ability to collapse groups (hidding their content). 👏 Thanks to Sultan S. for the suggestion. (#263)
- Added the possibility for deployements where the backend has a single instance (no replicas) to not use Redis with Socket.IO.
- Fixed a bug that would trigger the rate limiting when adding posts to groups, triggering a disconnection
- ⏫ Upgrading dependencies
- Add the ability to restrict the number of posts per user on a given session (as an option).
- Rename some folders in the repository to more sensible names
- Prevent the UI from sending more than 100 Sentry errors, to avoid spamming Sentry.
- Add a better check for self-hosted licences.
- ⏫ Upgrading dependencies
- Search now also works with the author's name, if the author is displayed. 👏 Thanks @ayxos for pointing this out. (#202)
- Replacing the reducer logic with Recoil for global state management.
- Adding the possibility of creating a post by clicking on the 'return' icon (⮐) instead of hitting "Enter". 👏 Thanks to @do606 for pointing out that Enter doesn't always seem to work (#246).
- Re-adding the ability of creating a post by hitting Enter on a numeric pad. 👏 Thanks again to @do606 for that.
- ⏫ Upgrading dependencies
- Add a page explaining how local encryption works
- Re-introducing rate limiting, both for the REST API and the Websocket connections, in Node and Nginx
- Reduce the quantity of data sent over Websockets (for instance, only sending post ID instead of whole post when voting)
- Reduce the number of SQL queries on the backend, simplifying the backend logic
- Return an error message to the UI if a Websocket message doesn't succeed
- Improve websocket reconnection logic
- Upgrading to Socket.IO 4.0
- ⏫ Upgrading dependencies
- 🐛 The participants footer was sometimes hidden by the blur overlay of a post. 👏 Thanks @Pajinell for pointing this out. (#240)
- 👏 Thanks to @cindyccook for pointing out reliability issues (#232).
- 🐛 Language loading issues
- 🐛 New users were wrongly added with a quota of 0
- 🐛 Fixed a bug with local storage
- 🐛 Fixed a bug where Slack OAuth was disabled
- Adding a 30-day trial
- Adding Microsoft OAuth 2.0
- Code splitting: all pages have their own bundle now, for a faster first-load experience
- Removing all
import React from 'react';imports, as they are now redundant. - Introducing Recoil.js (as an experiment)
- Limiting the number of posts to 50 for free accounts
- 🐛 Fixed a bug whereby adding multiple cards on a single group wouldn't work correctly (only the first card would be persisted in that group). 👏 Thanks to Daniel N. for reporting this by email.
- 🐛 Fixed a bug where adding an action was changing ownership of the post to the person adding the action. 👏 Thanks @botactic! (#209)
- Use TypeORM transactions for every database interactions, fixing some random races conditions.
- Improving multi-arch support
- Improving API calls and Sentry
- 🐛 Fixed a bug where groups couldn't be deleted if you didn't create them in the first place.
- 🚨 Emergency fix, for a serious bug that made it seem like a lot of people were participant to your session. This was never the case, it was displaying every non-logged in people as spectators to your session erroneously.
- Added the list of participants to the bottom of the screen 🧑💻
- Added a notification on connection or disconnection of participants 🟢 🔴
- Update OAuth photo on every login
- Replaced GitHub OAuth library by a more recent version, to avoid deprecated GitHub API.
- 🐛 Fixed a bug where the author of a new session wasn't registered as a participant
- 🐛 Fixed a bug where online participants were not showing
- [⭐️ Pro Feature] Encrypted Sessions: full client-side encryption of your data
- [⭐️ Pro Feature] Private Sessions: ensure only your colleagues can access your session
- Full support for password-based accounts
- Slack Authentication (OAuth) 🔑
- Replacing Travis by GitHub Actions for CI and Deployment 🚀
- New Freemium model
- Adding dynamic HTML title for better browser experience. 👏 Thanks @sam-pires! (#167)
- Adding a search functionality to find the needle in your haystack. 👏 Thanks @ayxos for the suggestion! (#171)
- Improving the Post component to hide up/down votes when they are disabled. Also got rid of the "flippable" panel, all actions are now visible directly. 👏 Thanks @Xyaren for pointing this out. (#150)
- Automatic Backend code linting, and CI linting
- ⏫ Upgrade to TypeScript 4
- ⏫ Upgrade to React 17
- ⏫ Upgrade to Create-React-App 4
- ⏫ Upgrade to Socket.IO 3.0
- 👏 A big thanks to @wooddar for beta-testing and his great feedback!
- Fixed a bug with GitHub authentication, where the display name was not set (#165). 👏 Thanks @hieuwu!
- 🐛 Fixed a bug where any user editing the name of the session would become owner of the session.
- 🐛 Fixed a serious bug under Firefox, where users could not see the content of the post (#154, #148). 👏 Thanks to all people who reported this (@Xyaren, @dallasgutauckis, @courtney-thwaites).
- 🇮🇹 Improved Italian translation (👏 Thanks @mventuri)
- Ability to delete sessions, if you are authenticated and you are the author of the session (#116)
- Allow changing the default language for new users via environement variables (#135)
- Allow a moderator to blur cards written by others, to keep everything hidden until the end of the retrospective (#100)
- Complete redesign of the Custom Session settings modal
- Ability to modify session settings once the game has started. This is only available to the session moderator (author) (#92).
- Ability to display past sessions for Anonymous users. This is limited to viewing past sessions on the same browser, any login to a different browser will create a different anonymous account, for safety reasons (#112).
- ⏫ Dependencies update
- 🇳🇱 Improved Dutch translation (👏 Thanks @jghaanstra)
- ⏫ Dependencies update
- Multi-architecture support! Hello Rasperry Pi 🍇 🎉! And Apple Silicon 🍎
- Docker images are automatically compatible with ARM (arm64, v6, v7, v8)
- Adding privacy policy, terms and conditions, GDPR support
- 🐛 Fix various bugs reported by Sentry
- Improvements on the landing page experience
- SEO
- Brand new landing page, and much improved look and feel 🎉
- Authentication using your favourite social media account:
- GitHub
- ...more coming!
- Ability to re-order posts by drag-and-drop 🚀
- Ability to group posts together
- Save your custom session settings as a default template
- Giphy support 😃
- Improved homepage dashboard 📈
- 🇷🇺 Russian Translation improvements (👏 Thanks @regmagik)
- Fixing logout button translation
- Adding fetch polyfill for IE
- ⏫ Upgrading dependencies
- 🇮🇹 Italian Translation (👏 Thanks @mventuri)
- Re-enabling source maps for Sentry
- ⏫ Upgrading dependencies
- Allowing a user to disable voting (by setting the max number of votes to 0) (👏 Thanks @imranismail)
- Fixing an issue with Docker and Yarn's installation
- ⏫ Upgrading dependencies
- Adding Sentry support for the backend
- Making Google Analytics and Sentry configurable at run-time (as in Docker run-time)
- Adding Copy to clipboard compatibility for more browsers
- Preventing the app from crashing when cookies are disabled on Firefox
- Handling disconnections better by not reconnecting automatically and displaying a message instead.
- Kubernetes configs. Deploy Retrospected to the cloud! ☁️ 🚀 ☸️
- Making the backend scalable by making SocketIO use Redis to communicate between instances. This is disabled by default and is only useful for Kubernetes deployments.
- The backend hostname is now configurable on the nginx config on the frontend.
- Replaced all occurences of
withRouterbyuseHistoryanduseParams - Added CI/CD support with Travis
- Auto-deployment of Docker images to Docker Hub
- Changing the UX related to Summary Mode
- Added the ability to copy the content of the session in the clipboard, both in Markdown format and Rich Text
- Added Error Boundaries to improve the user experience if the app crashes
- Added support for Sentry.io (error logging)
- Fixed an issue where multiline content was not displayed properly for anyone except the author
- Fixed an issue where a post couldn't be deleted if it had votes attached to it
- Issue 56 - Fixed an issue where new users who were not persisted yet couldn't vote (👏 Thanks @dkistner)
- 🇩🇪 German Translation (👏 Thanks @PaulBrandt)
- 🐛 Bugfix: First post was sometimes not saved on regular sessions
- IE fix: the previous polyfill didn't quite work with IE9 to IE11.
- Older browser support (IE11, somewhat works with IE10 and IE9).
- Adding an "outdated browser" warning
- Adding a remaining votes counter when using a maximum number of votes rule.
- Changing how Editable Labels work: they now only fire onChange on blur or Enter, minimizing the amount of traffic over the socket
- Removing the REACT_APP_DEBUG environment variable (using NODE_ENV instead).
- Adding a loading spinner while loading the game now that we can't predict which number of columns are going to appear on screen.
- Making sure index.html is not cached by Nginx on production
- Removing .map files on production
- MS Windows support/fixes (👏 Thanks @srraf).
- PR-48 - Fixed a word-wrapping issue when we have only one (long) post (👏 Thanks @manicmaniac).
- Fixes a possible race-condition issue with "vote" syncing.
- Adding full customisation of columns and rules:
- You can now create a board with 1 to 5 columns
- You can allow a user to vote for his own posts
- You can allow multiple votes on the same post
- You can limit the number of up and down votes
- You can choose to display the name of the author, and the name of the persons who vote
- Your language selection is now remembered between sessions
- Various UI fixes:
- Login modal improvements
- Editable label improvements
- Various Docker improvements
- ⏫ Upgraded dependencies
- 👏 Special thanks to @jesusabp, @zalexki and @jfritz for their inputs and ideas!
- ⏫ Upgraded dependencies
- Allows multi-line posts and comments (use the shift key to add a new line) (👏 Thanks @andyk314)
- Re-adding Hot Reload, which now works great with TypeScript and Create-React-App.
- ⏫ Upgraded dependencies
- Fixed an issue with Docker eating too much space with its unlimited log size. Log is now limited to 50mb.
- Added an "Action" field on each Post: this allows the user to define a list of actions that need doing in the next sprint, and allows displaying this list in the Summary Mode.
- 🐛 Bugfix: In certain conditions, some race-condition would store a post with a null session ID (so the post was lost forever).
- 🐛 Bugfix: Disabled the Web Worker, as it's not working properly when loading a game directly (and not loading the homepage).
- Adding support for Postgres migrations
- Adding created/updated fields on Post and Session
- 🐛 Bugfix: Summary mode wasn't ordered by votes anymore. (👏 Thanks @cindyccook)
- Complete rewrite
- TypeScript
- React Hooks
- @testing-library/react
- New component library (MaterialUI)
- Docker-friendly
- 🇯🇵 Japanese Translation (👏 Thanks @sat0yu)
- Simplified the ESLint configuration
- Introducing Prettier (
yarn format) - ⏫ Upgrading to Babel 7
- React 16
- Webpack 4 (for previous versions of webpack, see below)
- Using @bionikspoon/react-toolbox instead of the original
react-toolbox, as the project is no longer maintained and doesn't work with React 16. - ⏫ Upgraded all the other dependencies, everything should be up-to-date
- Improved the home screen
- Webpack 3 (for Webpack 2, look at version 0.9.0)
- Converting entire project to 2-space indentation
- ⏫ Upgrade other dependencies
- 🇵🇱 Polish Translation (👏 Thanks @olaf-cichocki)
- 🇦🇪 Arabic Translation (👏 Thanks @FrenchTechLead)
- Improved the loading screen
- Webpack 2 (for Webpack 1, look at version 0.8.1 and older)
- React 15.5 (which needs the new
prop-typesmodule, among other things) - React Router 4 (completely different way of doing the routing)
- Move the structure of the project to a modular structure
- ⏫ Upgraded all the other dependencies to the latest versions, except
react-toolbox
- Hotfix (ESLint errors on production build)
- Using redux-saga-testing to test sagas
- 🇹🇼🇨🇳 Chinese (Traditional and Simplified) Translation (👏 Thanks @aqutw)
- Using Yarn
- ⏫ Updating dependencies
- Fixing some Spanish translation mistakes (👏 Thanks @MrPolymath)
- 🐛 Fixed a bug where the Vote buttons would allow a user to vote multiple times (on the UI only)
- Good test coverage, using Jest
- 🇷🇺 Russian Translation (👏 Thanks @vectart)
- 🇪🇸 Spanish Translation (👏 Thanks @andresin87)
- Replacing PNG flags by SVG/CSS versions
- Using
react-hot-loader3.0.0 (beta2) for Hot reloading - Fixing a few mobile/responsive issues
- React-toolbox 1.0.0
- Debugging instructions
- Added the ability to edit existing posts inline (posts you wrote)
- Adding a new Invite button to simplify and explain how to invite other people
- Removing the snackbar
- Removing ES7 decorators, as they are not standard yet
- Removing hash on CSS and JS on production (not necessary since we have the version number)
- 🐛 Fixed a bug on the anti-spam when if using a proxy (nginx for instance), the wrong ip was used
- 🐛 Fixed a bug where the linting would fail if the default configuration was used (👏 Thanks @veselignome)
- Full support of ESLint, based on AirBnB rules
- Adding an anti-spam for SocketIO, because someone is having fun crashing my server (thanks!)
- Adding the possibility to join a previously joined session quickly (👏 Thanks @Sonaryr)
- Performance improvement on title edit (Also thanks to @Sonaryr 👏)
- New Logo!
- Added Favicons
- Updated the screenshot on the readme
- package.json version updated properly this time
- Improved the "Create Session" page, allows a user to create a session with a custom name
- Ability to edit that session name in real-time (by anyone)
- Added a "Summary Mode": this gives a summary of a current session, allowing a user to copy-paste the entire content easily
- New shorter session IDs
- New look-and-feel (new colours)
- Using reselect to create memoized selectors
- Improving performance by using
shouldComponentUpdatevia a custom base Component - Updated to the brand new React 15
- Improving Windows support by allowing Windows users to use the same commands as *nix users
- 🇳🇱 Internationalisation: added Dutch to the list of supported languages (👏 Thanks @Sonaryr)
- Adding support for more robust databases (NeDB, by default, in process, and MongoDB)
- Change to the Like / Unlike logic: a user can now only vote once, and not for his own posts
- Change to the Like / Unlike logic: like and unlikes counts are separated
- Adding ES7 decorators, more readable than the previous curry-ed functions
- Better support for Windows
- 🇧🇷 Internationalisation: added Brazilian Portuguese to the list of supported languages (👏 Thanks @renancouto)
- Using
redux-sagainstead ofredux-thunk - Persistence: Simple persistence to disk (no database needed)
- Support for Google Analytics (with precise events monitoring)
- Ability to logout, and to leave a session
- Improve the reliability of the clients list (currently connected users)
- Fix issues when the web fonts can't load (firewall blocking for example)
- 🇬🇧 🇫🇷 🇭🇺 Internationalisation: support for English, French and Hungarian (👏 Thanks @iaretiga)
- Minor visual tweaks
- Better console logs, server side
- Big clean up of un-used files and old libs
- First production version
- Basic functionalities are there and working
- Login
- Creating a session
- Joining a session
- Adding new posts
- Like / Unlike posts
- Ability to delete our own posts
- List of connected users
- No persistence (yet)
You can actually change the session ID in the URL with anything you like: for example www.retrospected.com/game/hello_world
Try not to take a too common name though, to avoid anyone else finding your session by chance.
Many thanks to the following contributors who helped translating the app:
- Hungarian: @iaretiga
- Portuguese (Brazilian): @renancouto
- Dutch: @Sonaryr, @jghaanstra
- Russian: @vectart, @regmagik
- Spanish: @andresin87
- Chinese: @aqutw
- Polish: @olaf-cichocki
- Arabic: @FrenchTechLead
- Japanese: @sat0yu
- German: @PaulBrandt
- Italian: @mventuri
If you are a native speaker of another language, please don't hesitate to make a pull request to add a translation.
Special thanks to @andresin87 for pointing the flag-icons package to me, it replaces the PNG flags in a neater way.
Another special thanks to Browserstack, as they allow me to test this project in other browsers.
Please make your PRs from the develop branch, not master.