Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

File Selector

Code for adding a File Selector to apps that use's Real Time Personalization (RTP) technology. This code is opensource and free to use, share, build upon and improve.

To code Real Time Personalization (RTP) technology into apps, developers may register for a free account at App development with RTP is free.


  • Introduction
  • Screenshots
  • Installation
  • Instructions & Endpoints
  • Troubleshooting
  • Example App
  • Maintainers
  • Contribute


The File Selector is JavaScript code that provides a simple, modern file selector for apps that use's Real-Time Personalization technology.

Using this code, apps will have the ability to display the genetic data files from the app user's account. The user will also be able to select one of the files from the list. The genetic data in the user-selected file will then be utilized when providing genetically tailored content.


Initial view

  • user can choose to view
  • list of sample files or
  • list of the user's file's that are stored at the user's account

![alt tag]( "Initial view")

Sample files list

  • if user selects 'I want to select a sample file' then the list of sample files will appear
  • user can select one file

![alt tag]( "Sample files")

File selected

  • user selected sample file 'Sheila'
  • that genetic data in that file will then be used to provide personalized content to the app
  • sample files allow user to experience Real-Time Personalization even if they don't yet have their own genetic data

![alt tag]( "User selected sample file 'Sheila'")


The code is provided in JavaScript and will work with any server side language for all modern web browsers. App developers can cut and paste the code into their apps so that their apps have a file selector that works straight out-of-the-box.

The file selector depends on Bootstrap and jQuery 1.11.3+.

  • Include both of these dependencies prior to using the file selector.

Review index.html for example code to initiate the file selector.

Installation steps

  1. Include Bootstrap and jquery

  2. Include file selector JS and CSS files from this repo

  • JS file: sequencing-file-selector.js
  • CSS file: style.css
  1. Create a hidden input in your form:
<input type="hidden" name="some-name" />
  1. Initialize the file selector on that form element, using this code:
$('input[type=hidden]').sequencingFileSelector({accessToken: 'the-oauth2-access-token-for-your-app'});

Instructions & Endpoints

This repo contains the code snippet for a File Selector. When added to your app code, the File Selector will allow your app to display a list of files securely stored in the user's account. Your app user will also be able to use your app to select a file. The selected file will then be used by whenever your app makes an API request to

While using, a user has the ability to store genetic data files (files that contain data about the user's genes) in different folders.

  • If the app user has files stored at, this File Selector allows an app to display the app user's files. It also allows the user to select a file to be used when the app sends an API request. will then process the API request using the genetic data from the file that the user selected when using this File Selector in your app.
  • If the app user does not have files stored at, this File Selector allows your app to display fun sample files provided by When using your app, your app user will be able to select one of these sample files and will then use that sample file data to process all API requests received from your app for that app user.

The user only has to select a file once and thereafter all API requests to will indicate that this specific file should be used. The user should also have the ability to select a different file at any time. Once a different file is selected, the newly selected file will be used by to process all incoming API requests from your app.

To learn more about's API, please see our App Chains repo.

The default settings for the File Selector will populate the File Selector with all user's files from all of the user's folders at If you do not want to use this default setting, you may modify the following endpoints to specify that only files from specific folders should appear in the file selector. If a folder is excluded from an endpoint then the app will not receive any information about files in that folder.

Folder Endpoint Code
All folders all=true
My uploaded files uploaded=true
Files shared with me shared=true
Files saved from my apps fromApps=true
My uploaded files & Files shared with me uploaded=true&shared=true
My uploaded files & Files saved from my apps uploaded=true&fromApps=true

The File Selector will display files from all of the user's folders using either of the following endpoints (they both return the same information):


The File Selector code should work straight out-of-the-box without any configuration requirements or issues.

Other tips

Example App

What types of apps can you personalize with Real-Time Personalization technology? Any type of app... even a weather app.

  • The open source Weather My Way +RTP app differentiates itself from all other weather apps because it uses Real-Time Personalization to provide genetically tailored content in real-time to each app user.
  • Experience it yourself using one of the fun sample genetic data files. These sample files are provided for free to all apps that use app chains.
  • The Weather My Way +RTP app usses the File Selector code from this repo.


The codebase is actively maintained by Please email the bioinformatics team at if you require any more information or just to say hola.


We encourage you to passionately fork us. If interested in updating the master branch, please send us a pull request. If the changes contribute positively, we'll let it ride.


Code snippet for adding a customizable File Selector to apps that use's Real-Time Personalization technology




No releases published


No packages published