Retromeet is an application meant for using during Scrum retrospective meetings, but it can also be used for other purposes whenever a board with columns and cards is needed. Basic functionality includes:

• setting your username
• creating a new retro with custom columns
• adding/editing/deleting cards inside columns
• cards voting with votes limit
• going through different stages of the meeting

The app uses OCRA, which derives from Create React App, but there are some custom solutions included as well. They will be described further below.

The project is divided into client and server parts.

• Install docker
• rename all configuration files .docker/.env.dist -> .env, config.server.json.dist -> .env, .env.dist -> .env,
• enter .docker directory and use: docker-compose up --build -d

Alternatively if you don’t want to use docker you can run both client and server manually:

install and run mongodb

yarn install

yarn start:client

yarn dev:server

src/client

On the client side we use material-ui components and their solution for CSS in JS.

The forms in the app(e.g. create, join retro) are implemented using redux-form and redux-form-material-ui components.

website/services/websocket

We are using a custom WebSocket Provider that uses socket.io.

website/i18n

We are using custom Locale Provider based on react-intl. It’s basically a wrapper around IntlProvider.

src/server

On the server side we use mongoose object modeling.

Application structure is action based (like a client redux implementation). Directory contains actions catalogue with a set of actions based on the application state and model catalogue with a mongoose models. In order to add new “action” it’s necessary to add new directory with two files <action_name>.actions.js and <action_name>.handlers.js. The .actions.js file defines which actions are being implemented in the socket and defines their name. The .handlers.js implement handlers for those actions which takes given parameters and state to interact with mongodb through mongoose models. Results can be emitted or broadcasted (through action-performer.js). Created actions are being automatically handled while connecting to socket.