how to guide

Using xs:code for offering SERVICES


Offering paid services to your users is a great way to monetize an existing open source project, while keeping it completely open source and free. You can offer repository related services, such as support, bug fixing, customization and more.

1. Getting started

First, you’ll need to decide which services you want to offer. You can offer your services as a one-time fee, or as an ongoing subscription.

Here are some ideas for services you can choose from. You can choose more than one, or add your own ideas.

Support Hours
Provide users with a limited amount of hours they can use to contact you for support and get help with using your code.
Bug fix priority
Give paying users a priority when they discover a bug that needs fixing.
Integration and Customization
Accomodate special requests, integrations and tailor made customization.
Paid Hosting
Provide hosting services for your code (on the cloud or on your own servers)

2. Import your public repository

First, you’ll need to add your public repository, which is the foundation on which you will create your paid items.

Click “Add repository” and follow the instructions. You’ll need to install our Read-only Github app on you repository for verification purposes. 

3. Create an item for sale

Now, let’s create your paid item.
Under your public repository, click “Add item“, and select the “Service” item type. Be sure to add a description of exactly what you are offering, and if you have any special terms, such as your availability.


Choose your item’s pricing and billing model.
Select from one-time payment or recurring subscription (monthly/annual). You can even set multiple prices/billing models per item.

You can create as many items as you like, each with a different price and billing model. We recommend one-time fee billing for service items.


The best place to start promoting your paid items, is on your readme file. 
Use our badge to place a link to your xs:code repository page (Looks like: to notify people who use your project about the items you are offering.

You can also use social media, blogs and developer community websites to publish your paid items.

Need help with PROMOTING your project?

Check our promotion guide, or contact our community team at [email protected].
They can help with setting up your project and help make sure you get as many paying customers as possible.