This README is a work-in-progress. Please check the issues to see if something has not already been flagged for review.
See QUICKSTART.md
.
The Prifina app is a container application and this starter repository helps you develop apps within that platform. As a third-party developer, you can download Prifina's pre-built libraries, assets, and components to then design and craft your own application to be hosted on Prifina's platform.
Warning: Since our starter app is already built on React, there is no need to run create-react-app
.
As a third-party developer, you can design and create React applications that will be hosted on our user-held data platform which runs users' personal data clouds (hosted on AWS). In order for your app to interface with users' personal data, you'll want to use either props or context providers.
In order to publish your app on our platform, we ask that you provide a manifest file that contains an archive of your build deployment package. Our Prifina platform team will review it for approval.
The manifest.js
file should have a Prifina appID
field. Currently, registration for an appID
can be requested in our public Slack workspace.
An easy way to start building your application is to fork the relevant Prifina repository. You can also use open-source components and assets located in our Blend Design System library or Storybook. You do not need to use these resources, but they are designed for learn best by building.
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.
New kinds of applications can be built by mixing data from different data sources and/or combining them with public data sources: An example would be to combine a user's personal streaming data with publicly available movie/television review data.
In addition to data that your application is using, you might consider what sort of new data your application generates for users: This in and of itself becomes a new data source for other applications.
Submit the data source information your applications will use:
Here are some things to consider when thinking about data in your app:
The App Market has the following fields that need to be filled out to describe the application and its various functionality:
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.
Build a Prifina app with the Prifina Starter and utilities.
Test locally or use the Prifina launcher to test your code in the Prifina platform.
Q: Do I have to use this starter repo to develop for Prifina?
A: If you would prefer to develop from scratch, we welcome you to do so.
Q: Do you support any JavaScript frameworks aside from React?
A: We will gradually expand our support for other JavaScript libraries and frameworks.
Q: I can't register as a developer. How do I get my appID?
A: Get in touch with us on Slack.
To reach us, you can join our Slack or email us @ developer@prifina.com!
https://dev.prifina.com/
https://docs.prifina.com/
https://www.prifina.com/