SDK Introduction

Last modified: November 27, 2023

1 Introduction

The Mendix Platform and Model SDKs are TypeScript- and JavaScript-based SDKs, which give you access to the inner-workings of every Mendix app. These SDKs enable you to work with your app efficiently via code, and automate any tedious or error-prone task.

With the Mendix Platform SDK and Mendix Model SDK, you can do the following:

  • “Read” from your app model (for example, analyze the quality of your app model, or generate a high-level diagram to document your app)
  • “Write” to your app model (for example, create a new entity in your domain model, add an activity to an existing microflow, or even generate a whole new Mendix app based on a legacy code base)

1.1 Mendix Platform SDK

The Mendix Platform SDK allows you to work at the app level. Currently, the Mendix Platform SDK implements the following functionality:

  • Create a new app
  • Delete an app
  • Create a temporary working copy for editing an app model using the Mendix Model SDK
  • Commit the changes in a temporary working copy back to the Mendix Team Server
  • Get information about a repository, its branches and commits

1.2 Mendix Model SDK

With the Mendix Model SDK, you can read, modify, and analyze every metamodel element of your app model. This includes domain models, microflows, pages, integrations (consumed and published web services), Java actions, custom widgets, security constraints, and so on. Anything you can access with Studio Pro, and all the technical details we abstract away in the UI, are part of the app model.

When analyzing app models you get a lot of power: you can access every tiny detail in the model so that you can reason about the entire model, analyze it for quality, or export it completely.

2 Getting Started

2.1 Quick Setup

To set up the Mendix Platform and Model SDKs, perform the following steps using a command line console.

  1. npm init --yes
  2. npm install -g typescript
  3. npm install mendixmodelsdk mendixplatformsdk when @types/when --save
  4. tsc --init

2.2 Detailed Resources

For detailed information on getting started with the Mendix Platform SDK and Mendix Model SDK, see How to Set Up Your Development Environment.