This quickstart guide will walk you through deploying your first server-side app using monday code.

Working on a client-side app instead? Watch our video tutorial to learn how to deploy client-side apps using the monday code CLI.

Prerequisites

• Node 18+
• npm

Step 1: Install the monday code CLI

First, install the monday code CLI using npm:

npm install -g @mondaycom/apps-cli

Step 2: Create an app feature and enable monday code

Each instance of monday code must be connected to an app. Create your app and integration feature:

1. Create a new app.
2. Add a new app feature.
   1. Select Integrations for sentence builder and click Next.
   2. Choose the Quickstart Integration - NodeJS template.
   3. Check the box to automatically add any missing OAuth scopes.
   4. Ignore the scaffold command prompt. Instead, add a dummy URL: https://myserver.com.
   5. Click Create.
3. Enable monday code on your account. You must be an admin to do this step!

Step 3: Deploy the app

Clone our example app

Clone our example code or download it from Github:

git clone https://github.com/mondaycom/welcome-apps.git

Change your working directory to apps/quickstart-integrations-monday-code:

cd apps/quickstart-integrations-monday-code

Deploy the app

Use the CLI to deploy your app to monday code servers. Run the following command, then select the app and version you created in the previous step:

mapps code:push

The CLI will take a few minutes to deploy and build your app. You will see a success message when the process is complete.

Set environment variables

Copy your app's Signing Secret from the General settings tab in the Developer Center.

Use the CLI to add your signing secret as the MONDAY_SIGNING_SECRET environment variable:

mapps code:env -m set -k MONDAY_SIGNING_SECRET -v <your_signing_secret>

Step 4: Connect your integration feature to your app backend

The final step is to connect the app feature in monday to your backend.

1. Navigate to the Features tab and select the relevant app feature.
2. In the Feature deployment section, select Server-side code from the dropdown.
3. Leave the subroute field empty.

Step 5: See your integration app in action

Now, set up your integration on a monday board and see it work!

1. Create a new board.
2. Create two text columns.
3. Click Integrate to open the Integrations Center and locate your app.
4. Choose the template: When Text column changes, transform it to into text column.
5. Configure the fields of the recipe and click Save.
6. Add text to your input column. The text will be capitalized and automatically appear in the output column.