Mendix 7 is no longer supported unless you have Extended Support (for details, please contact Mendix Support). Mendix 7 documentation will remain available for customers with Extended Support until July, 2024.

Start Your Own Repository

Last modified: April 18, 2024

1 Introduction

In this how-to you will learn how to set up a GitHub repository. The repository will contain your development content and can be shared with others, in order to contribute to the application.

2 Preparation

3 Creating Your Repo

First of all, your repo needs a name. We advise you use the same name that it is/will be published under in the Marketplace, and then using UpperCamelCase to replace spaces. For example: “My first app” would be “Mendix/MyFirstApp” on GitHub.

Same as with the description. It should say what the App does, so it would be easiest to keep this in line with the App on the Marketplace.

(Add the Mendix .gitignore to make sure you keep your repo clean.)

4 Making a Widget

When making a new widget, Mendix suggests you Build a Pluggable Web Widget.

5 Releases

If you want to make a new release for the Marketplace, we advise you start off with a new tag on the appropriate commit on the production or release branch. From these tags, you can create a new Release in GitHub. In this release you can set your release notes (which you can then use for the Marketplace release as well) and give it a more official name. If you add the .mpk as a binary file to the release tag (see image blow) the Marketplace will automatically sync the .mpk to your new draft. Mendix suggests also linking this to the upcoming Marketplace release by mentioning that release number in the description.

6 Read More