Understanding Rocket.Chat’s server repository structure is a foundational requirement for developers. This document describes the repository structure so you can become familiar with it before you begin developing.
Additionally, note the following points:
The server's architectural design prioritizes modularity and clarity, which is reflected in the repository structure, segregating functions for diverse developer levels. You can also refer to the server architecture for details.
Rocket.Chat uses a monorepo to house essential code and packages required by various projects, such as the Apps-Engine and Livechat. This makes maintaining and sharing the code easier and allows developers to work on different projects simultaneously.
Rocket.Chat builds its components using the Meteor framework and React. You should be familiar with the Meteor and React project structures.
In the near future, Rocket.Chat will move away from Meteor to a more manual structure, which will allow it to be more flexible and scalable.
The directory structure is as follows:
Rocket.Chat
├── README.md
├── _templates/
├── apps/
│ └── meteor/
│ ├── app/ # Features of Rocket.Chat
│ ├── client/ # General frontend only related code
│ ├── definition/
│ ├── ee/ # Enterprise related code
│ ├── imports/
│ ├── install.sh*
│ ├── lib/ # Helper functions, classes, and methods
│ ├── package.json
│ ├── packages/ # Meteor packages customized in use
│ ├── private/ # Private files and assets only available within the project
│ ├── public/ # Publicly available files served directly from the project root
│ ├── server/ # Server side only code
│ ├── tests/ # Tests
├── ee/
│ └── apps/
├── package.json
├── packages/ # Houses sharable code that can be used by different projects
│ ├── agenda/
│ ├── api-client/
│ ├── cas-validate/
│ ├── core-typings/ # Type definitions used for core Rocket.Chat
│ │ ├── src/
│ ├── eslint-config/ # Config files and rules for code and unit tests
│ │ ├── best-practices/
│ │ ├── errors/
│ │ ├── ...
│ │ └── variables/
│ ├── livechat/
│ ├── model-typings/
│ ├── models/
│ ├── rest-typings/ # Signatures of endpoints
│ ├── ui-client/
│ ├── ui-contexts/
│ └── ui-video-conf/
Let’s look at some fundamental details:
Directory | Description |
---|---|
| This directory shows the various features Rocket.Chat offers. Each primary folder here contains a |
| Every Rocket.Chat page a client-side user interacts with is a result of multiple components working together. A good starting point for beginners to see how this works is the |
| This is a collection of objects that are reused on all client sides. This exists to limit code duplication, encourage contributors to use the code already in the codebase, and avoid re-implementing logic or re-creating functions. |
| This directory houses any meteor packages used in the project or customized for a specific purpose. Notable examples include the meteor-accounts-linkedin for LinkedIn login service, rocketchat-i18n for internationalization, etc. |
| This directory contains all Meteor methods. |
| This directory holds versatile functions related to server-side code. |
To learn more, see the Meteor guide.
Rocket.Chat is incorporating new features that won't adhere to the legacy Meteor structure within the
apps/
directory. These new features will adopt a distinct structure, while the existing code structure will continue to be mantained.
Now that you are familiar with the repository structure, you can confidently continue with your server environment setup.