Start Your Own GitHub Repository

Last modified: February 20, 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 for others to contribute to an application or Marketplace component.

2 Preparation

3 Creating Your Repo

First of all, your repo needs a name. You should use the same name that will be used for the item published in the Mendix Marketplace. Use UpperCamelCase to replace the spaces (for example, My first app becomes Mendix/MyFirstApp on GitHub).

The description should say what the item does. This description can also be used in the Mendix Marketplace.

Add a .gitignore file 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 Mendix Marketplace, start 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, set your release notes (which you can then use for the Marketplace release as well) and provide an official name. If you add the .mpk file as a binary file to the release tag, the Mendix Marketplace will automatically sync the .mpk to your new draft:

You should link this to the upcoming Mendix Marketplace release by mentioning that release number in the description.

6 Read More