From Zero to Deployed: Building with the Sitecore Marketplace Starter Kit
Whether you’re building a custom or public app, the process follows a clear path. This guide is tailored for developers who want to get hands-on with Sitecore Marketplace and start building apps. The Marketplace Starter Kit provides the basics to get started along with example implementations of all extension points. From setup to deployment, this chapter walks you through the essentials so you can go from zero to deployed with confidence.
Not sure what all these terms mean?
Maybe you missed the marketplace introduction article.
1. Prerequisites
Building marketplace apps requires Node.js v16+ and NPM v10+. The Marketplace SDK is created in JavaScript so it supports any JavaScript based frontend framework such as React, Next.js, Angular and more.
2. Create your app
You can create the app in several ways.
- Create empty app using your preferred JS Frontend Framework e.g. using Next.js app router or page router approach
- Using the marketplace starter kit (uses Next.js and app router)
This example builds based on the starter kit.
2.1 Create new repository from Marketplace Starter Kit
The marketplace starter kit has been created as a template. You can use that template to create your own marketplace app.
Go to https://github.com/Sitecore/marketplace-starter and create a new repository from template.
Choose a meaningful name for the app you want to build. Add a description and set the visibility to public or private.
2.2 Clone your repository to your local
Install packages using npm install
The file structure should look like that now:
The marketplace starter repository quick starts your implementation by providing a preconfigured solution. The useMarketplaceClient.ts instantiates the marketplace client.
Within the app folder you can explore example implementations for each extension point. Find more information in the ReadMe file of the repository.
2.3 Test app
Start your app running npm run dev
Following the different routes, you can see the sample implementations.
Open e.g. http://localhost:3000/custom-field-extension
Please note: You don’t see the environment related output because the app is not running in the context of XM Cloud.
2.4 Example implementations
Learn from a set of example implementations how to utilize the Marketplace SDK and the different extension points.
- Icon Picker: https://github.com/Sitecore/marketplace-icon-picker
- Google Analytics: https://github.com/Sitecore/marketplace-google-analytics
2.5 Consider unified UI
When starting to build, please note that we strongly recommend designing your app’s UI in line with Sitecore’s interface guidelines to provide a consistent and familiar experience for users.
Want to know how to register your app with Sitecore?
Learn how to take your custom Marketplace app from development to deployment. This guide walks you through the final steps—registering your app in the Sitecore Cloud Portal, selecting extension points, configuring API access, and making it available to your organization.
Resources
| Resource | Link |
|---|---|
| Feedback Form | https://forms.office.com/e/cEndu1JLQc |
| Documentation | https://doc.sitecore.com/mp/en/developers/marketplace/testing-and-debugging-a-custom-app.html |
| Marketplace Next.js Starter Kit | https://github.com/Sitecore/marketplace-starter |
Read more
Unlock Sitecore’s Potential: Introducing Sitecore Marketplace Custom Apps
Discover how Sitecore Marketplace Custom Apps empower developers, architects, and marketers to extend Sitecore with modular, purpose-built solutions. This article introduces the concept of Custom Apps, explains their role in a composable architecture, and highlights how they unlock new capabilities across Sitecore products—without touching the core.