Creating the Codebase

Last edit: Jun 05, 2019
  • Contributors:
  • diana-lakatos
  • pavelloz

This guide will help you create the codebase using the Marketplace Kit.

In order to correctly communicate with the platformOS engine and API, your codebase should be organized into a specific directory structure. The root directory of your project should contain the marketplace_builder directory.


This guide explains how to create your codebase using the Marketplace Kit. Alternatively, you can create your directory structure by Downloading the Codebase of an Instance you created or have access to.


You can create the codebase using the Marketplace Kit, so you have to have it installed on your computer. This functionality is available from version 1.0.6, so make sure you update your Marketplace Kit to the latest version.


Creating the codebase with the Marketplace Kit is a two-step process:

Step 1: Create the directory structure

To create the codebase, enter:

marketplace-kit init

Marketplace Kit downloads the directory structure in a zip file, and extracts it into the current directory.

Step 2: Explore your directory structure

Once you've downloaded the codebase, locate and explore it – this is how the directories and code of your platformOS Instances should be organized.

To learn more about the required directories and files, check out our detailed description of the platformOS Codebase.

Next steps

Congratulations! You have created the codebase for your Instance using the Marketplace Kit. You can now deploy and sync changes to your Instance.


We are always happy to help with any questions you may have.