Skip to main content
Version: 2.33.0

Marketplace: Development Setup

The Marketplace offers custom plugins that can be installed in your ToolJet instance. This guide aims to assist you in creating a new plugin for the ToolJet marketplace.

Requirements

Getting started

Step 1. Setup ToolJet locally

To obtain the ToolJet repository via git, use the command:

git clone https://github.com/ToolJet/ToolJet.git

Next, refer to the appropriate guide for your development environment to follow the Setup instructions:

Step 2. Enabling the marketplace for your instance

To enable the marketplace for your ToolJet instance, you need to specify the following environment variables in your .env file:

Marketplace feature enable

Use this environment variable to enable/disable the feature that allows users to use the marketplace.

variablevalue
ENABLE_MARKETPLACE_FEATUREtrue or false

Enable Marketplace plugin developement mode

The use of this environment variable facilitates plugin development by enabling automatic builds whenever package changes occur, thus simplifying the development process. Moreover, it also incorporates a reload button that retrieves all the recent local modifications from the file system for installed plugins, making it a valuable feature for improving the overall development experience.

variablevalue
ENABLE_MARKETPLACE_DEV_MODEtrue or false

Please note that the marketplace is not enabled by default. After updating the variable, restart your ToolJet instance.

For information on running ToolJet on your local machine, please refer to the instructions provided here. You can access the marketplace by navigating to the '/integrations' route.

Step 3: Installation of tooljet-cli

In order to manage plugins for the ToolJet marketplace, including creating, updating, and deleting, you will need to utilize tooljet-cli. This can be installed via npm by entering the following command:

npm install -g @tooljet/cli

# Ensure the installation was successful
tooljet --version

Having completed the environment setup for Marketplace Developer mode, we can proceed to the next section and commence with developing the first plugin.