# Getting Started

# Introduction

Prifina provides a user-held data platform that allows you to build React applications that the user can install via our App Market and run them in their personal data clouds (AWS). These apps use props or context providers as the interface to connect with users personal data.

To get your application published in our App Market, you will need to supply the Prifina team an archive build deployment package with the relevant manifest file, to be reviewed by the Prifina App market team.

# What Application to Build?

If you are wondering what data is available to build your application on, you can download the type of data that the users have, from looking at the Prifina Your Data page. We recommend that you simply download your own data from any of these platforms or identify any other sources that are most interesting to you.

Probably the most interesting new type of applications can be built by mixing data from multiple different data sources and or combining those with public data sources, an example would be combining streaming data from personal data and utilizing it with publicly available movie/series data.

In addition to data that your application is using, you should also think about new data that your application will be able to generate for the user, that will become a new data source for other applications.

# How to Start?

When you have decided the application you want to build and have the data sources identified, a simple way to start building is by simply forking the relevant GitHub library(opens new window) and start building your own app.

You can also use these open source components from our Blend Design System library in our Storybook, and other useful assets from our GitHub.

You do not need to use these assets, but they can help get you started.

# Application Data Model

# Data Source Details

Submit the data source informaion your applications will use:

  • Data source URL, description
  • Data Model and API Documentation URL if available
  • Description of data objects and fields to be used
  • How you plan to use this data in your application
  • Additional notes

# About New Data Your Application Generates:

  • Data Category
  • Description of data objects and fields
  • Additional notes
  • Document Your App Data as a GraphQL Schema
  • The end result for interacting with user-held data is documented in GraphQL Schema format
  • Document your application data model as a GraphQL schema and send it to us for review along with schema visualization
  • We will integrate it with our Open Standard Master Schema and provide you with the supported data model to use in your final application

# Helpful Tips

Here are some things to consider when thinking about data in your app:

  • When considering the data model for your application, look into any open, industry or de facto standards where available
  • New personal data that your application can create has increasing value to your customer and other developers
  • What ‘log data’ you will need for debugging your application
  • What non-personal / statistic data can your application create that may have value for your customers or other developers
  • What transactional data your application will generate
  • Any configuration data you may need

# Getting Your Application Published

# Application Details for App Market

The App Market has the following fields that need to be filled out to describe the application and its various functionality:

  • App name
  • Description [max 250 characters]
  • Key Features
  • Application Screenshot Images [SVG, GIF, JPEG under 5mb]
  • App Publisher name
  • Type of Application, Local Data App, Widget App or Profile Data App.
  • Application Category
  • Available User Interfaces (Desktop Browser, Mobile Browser, Mobile App)
  • Languages Supported
  • Age Restrictions
  • Data Permissions, what type of data your application will require
  • Support Contact

# Package Your Application

To get your application published in our App Market, you will need to supply the Prifina team a .Zip build deployment package with the relevant manifest file, to be reviewed by the Prifina App market team.

# Get In Touch

To get in touch with us you can join our Slack(opens new window) or email developer@prifina.com

# FAQ

Q: Do you support other JavaScript apps than React?
A: We will gradually expand our support also for other JavaScript libraries and frameworks.