Rocket.Chat
Mobile App
Desktop App
Omnichannel
Apps Engine
Reference
Fuselage
App Submission to the Marketplace
So, you just finished writing your first Rocket.Chat App, and you have successfully tested it locally which means you are ready to submit it to the Marketplace for others to use. This article will take you through the process, step-by-step.
When you submit an App, there is a three-step process that takes place. In the first step, you submit the App to the Marketplace (explained below). Secondly, you will receive an email that asks for you to approve or reject the App submission (more on this later as well). Finally, after you approve the entry, then our staff will review it and determine whether it is to be approved published or not.
Packaging the app
Currently the Rocket.Chat servers and Marketplace allow submission of zip files, these files can be created by running
rc-apps package which packages your app and creates the zip file under dist folder.App Submission
To be able to submit an App to the Marketplace, the Publisher must have a Rocket.Chat Cloud Account and register their Publisher Account.
Submission through CLI
To submit your App simply run:
rc-apps submit
Submission through CLI just sends the App in a
draft state. The Publisher must access the Portal to be able to submit the app.Submission through Publisher
To submit an app through the publisher:
- 1.
- 2.Log in using your account
Or Sign up for your publisher account, as shown below:
Your publisher developer account is created, as shown below:
To add a new app:
- 1.Click New App
Following screen appears:
2. Drag and drop your app package, as shown below:
Click Next and set details of the app you're going to publish.
Set App details:
- 1.Set your app's name under App Name.
- 2.Use Upload new app button to upload and set a display picture for your app.
- 3.Select a category for your app in Categories drop-down.
- 4.Select a Language for your app in Languages drop-down.
Purchase Type:
In the following section we will guide you through different purchase types. You can choose the one that suits your needs.
Your users are allowed to buy the app per workspace. If they have two workspaces and want to use the app on both, they need to buy the app separately.
One-time Purchase:
Please use One-time Purchase when you want your app to have a one-off payment and your users are allowed to use it forever after that payment. To set it:
- 1.Select One-time Purchase
- 2.Enter the price you want to set
Subscription:
When you want your app to be subscription-based, you can use Subscription purchase type. An example of this volume-based pricing is shown below:
- 1.Select Subscription
- 2.Click Add pricing plan
New Pricing Plan pane appears:
3. Select your subscription Strategy (Monthly/Yearly)
4. Mention the Price
5. There are two types of subscribtion plans to to choose from:
5.1 Per Seat Subscription
If you want your app to have a per seat subscribtion check mark Per Seat box.
Per seat subscribtion allows your customers to pay per seat for the app rather than paying for a tier of users.
5.2 Tiers Subscription
​
Free:
You can make your app available to your customers free of cost, as shown below;
App Info
Next you can set your app info:
- You can upload some images of your app, (Screenshots (1200x600 px), (max of 5 images))
- Set its description
- Mention privacy and data handling rules
as shown below:
Publish App
Hit Publish Changes, as shown below:
Your app is published successfully, as shown below:
Process after successful submission:
After successful submission following events happen at Rocket.Chat side, that you should be aware of:
- Compiling
- Approvement
- Publishing
You can see the status of your app as compiling, as shown below:
After we compile, you will be notified via email, as shown below:
Then you get notified to review your app, as shown below:
You log in to your cloud account and approve it.
After your approval, rocket.chat reviews it, and you will be notified via email that your app is now Published (listed).