# How to Create a Service App for the ORCA Marketplace

### Steps to Create a New App

1. Visit [**https://developers.orcasandbox.com/**](https://developers.orcasandbox.com/)&#x20;
2. If you have an existing account, use your credentials to log in to the Developer Portal. If you haven’t already created a developer account, click “**Sign Up**” and complete the registration form to gain access to the ORCA API Platform. When you initially sign up or prior to having your first Service App approved, your account will be in “sandbox mode”, allowing you to explore, test, and modify your app within a controlled, yet functional staging environment.
3. Navigate to the “**My Service Apps**” tab and select “**Create New Service App**” from the dropdown menu. You’ll then be prompted to provide a name for your Service App. After submitting the name of your app, you’ll be taken back to the My Service Apps main menu.
4. Now it’s time to provide additional details about your service. To add information, select the service  from the My Service Apps dropdown menu, then click “**Settings**” from the sidebar and populate the available fields. You’ll notice that the Service App name has already been populated. However, you'll be able to change the name of the app before submitting it for approval at any point from the Settings section.&#x20;
5. Preview and test your Service App in sandbox mode and feel free to make additional edits to the description prior to submitting for review.
6. When ready, submit your Service App for consideration, along with a business verification agreement certifying the service is HIPAA compliant.
7. The ORCA team will review your request and supplemental documents. You will receive a notification when the Service App is approved or if additional information needs to be submitted.&#x20;
8. Once your Service App is approved you may request permissions. Each permission has its own set of requirements. Should multiple permissions be requested, the ORCA team will review each one individually. Limit permission requests to those absolutely necessary for the service.  &#x20;
9. When permissions are granted, your Service App will be added to the **ORCA Marketplace** for users to install and your account will be moved from sandbox mode to production mode, enabling faster submissions in the future. &#x20;

### **Required Components for ORCA Service Apps**

The following is a complete list of components you’ll be asked to provide for each Service App in order to have it showcased on the ORCA Platform. &#x20;

1. 1. Service Name
   2. Service Provider Name
   3. Service Provider Logo
   4. App Version
   5. Short Description&#x20;
   6. Long Description&#x20;
   7. How it Works&#x20;
   8. Pricing Description
   9. Marketplace Thumbnail&#x20;
   10. Marketplace Banner&#x20;
   11. Video (optional but recommended)

### How Service Apps Are Found and Displayed

Service Apps appear in multiple sections throughout the ORCA Platform. The view in each section may vary, and so, will require specific components of the service to be provided.&#x20;

Below are some examples of the sections where Service Apps can be found on the ORCA Platform, the components  needed for each view, and how the service will be displayed to users.&#x20;

#### **Installed Services**&#x20;

The Installed Services section contains a list of services the user installed. Services are displayed as tiles. Each tile must include the following:&#x20;

1. **Thumbnail:** An image banner that includes the service name
2. **Short Description:** Two lines of text describing the service
3. **Service Provider:** Name of the business or company offering the service
4. **Version:** The current version of the Service App

![](https://2628351299-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp-GGFDRT053dVKtILV%2F-Lp9bZSuAxSi5wy7Athn%2F-Lp9bmDG1BuGI8XhzdIa%2FServices%20Index%20Copy%202.jpg?alt=media\&token=f6e1694e-6ef6-4d16-a1c6-df3ceb4da94f)

#### Marketplace&#x20;

The Marketplace is where ORCA users can browse available services and obrain additional information regarding each. A similar tile as seen on the Services section will be displayed on the landing page. The difference being that only installed services will display the version number.

### Service Detail Page

When a user clicks on the tile, they will be taken to the Service Detail page, where additional information about the service will be displayed, including the below:

1. **Service Name:** Name of the service or solution
2. **Marketplace Banner:** Banner image with company logo or icon related to the type of service being offered
3. **Long Description:** A more comprehensive explanation of the service. May be in paragraph format, bullet points, or a combination of both.&#x20;
4. **Video (optional but recommended)**&#x20;
5. **How it Works:** A brief explanation of the service's purpose, functionality, and benefits
6. **Install Button:** A call to action section including service provider name and logo, service category, user ratings, link to user reviews, number of installs, pricing information, and add service button.

![](https://2628351299-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp-GGFDRT053dVKtILV%2F-Lp9bzF2qzfX25Geje0K%2F-Lp9c4SRPeuEhyfR5Rwc%2FMarketplace%20Detail%20Copy%202.jpg?alt=media\&token=f9f7aaf0-d828-4d6d-9070-55b4cefd518c)
