CardinalKit

CardinalKit

  • Docs
  • Community
  • Resources
  • Blog

›Reference

Getting Started

  • Generate CardinalKit App
  • Set Up Application Infrastructure
  • Alternative Authentication Methods

Reference

  • App Customization Guide

Open Source

  • Contributing to CardinalKit

App Customization Guide

Note: these features are currently only available on the currently experimental swiftui branch of the CardinalKit repository

CardinalKit provides quick customization options for your health research application through the CKConfiguration.plist file. This file is a spreadsheet that maps CardinalKit-defined keys to user-selected values. This reference shows you how to customize that file to suit your needs. Every key must have a value or the app will crash.

The default CardinalKit sample app with no CKConfiguration.plist changes.

CKConfiguration Keys and Values

KeyValues
Study TitleThe title of your application
Team NameThe name of your team or department
EmailA support email for users to contact
PhoneA support phone number for users to contact
CopyrightA copyright/informative statement that shows up at the bottom of the Profile view
WebsiteA website URL with more information about your app
Tint ColorA hexadecimal color for secondary text and iconography in ResearchKit popovers (i.e. #b6133f)
Primary ColorA hexadecimal color for buttons and text throughout the CardinalKit app
Review Consent Step TextText for consent form review
Consent File NameName of saved consent pdf file
Reason for Consent TextText for consent alert
Passcode TextText for passcode selection
Passcode Type4 or 6: The number of numbers in the passcode
Completion Step TitleTitle for completing onboarding
Completion Step TextSubtext for completing onboarding
Failed Login TitleTitle for failing login
Failed Login TextSubtext for failing login
Health Permissions TitleTitle for requesting health permissions
Health RecordsAccess user health records using Apple's FHIRModels by setting Enabled to 1
Health Permissions TextSubtext for requesting health permisions
Background Read Frequencyimmediate, hourly, daily, or weekly: How often to read from HealthKit data records
Login-Sign-In-With-AppleSee below
Login-PasswordlessSign in using a passwordless setup (this process also needs to be activated on Firebase — refer to our documentation to get started)
Login Step TitleTitle for logging in
Login Step TextSubtext for logging in
Withdrawal Instruction TitleTitle for withdrawal step
Withdrawal Instruction TextSubtext for withdrawal step
Withdraw TitleTitle to show after withdrawing
Withdraw TextSubtext to show after withdrawing
Passcode On Return TextText to show when user returns to app and sees passcode request
Consent TitleTitle of consent form document
Use CarekitEnable a CareKit dashboard as a tab in the application
HealthKit Data to ReadA list of HealthKit Object types to read from the user (see: HealthKit Object Types)
Consent FormSee below. At least 1 section is required.
OnboardingSee below. At least 1 panel is required.

Consent Form Specifications

The values to this element in the file will construct the consent process. At least 1 section is required.

Consent Form Items
Overview
Data Gathering
Privacy
Data Use
Time Commitment
Study Survey
Study Tasks
Withdrawing

Onboarding Specifications

The Onboarding key is an array of dictionary items. Each dictionary represents a single panel in the onboarding paging view.

KeyValue
TitleA title for the page
DescriptionA description for the page
LogoAn emoji or number for the page

Sign in with Apple

The Login-Sign-In-With-Apple key is an array of dictionary items. Before turning this feature on, make sure you have taken care of the necessary setup.

KeyValue
EnabledWhether Apple sign in is enabled (1 or 0)
TitleA title for the sign in invocation
TextText to go with the sign in process

Have any ideas for keys/values for this file? Submit an issue request.

← Alternative Authentication MethodsContributing to CardinalKit →
  • CKConfiguration Keys and Values
  • Consent Form Specifications
  • Onboarding Specifications
  • Sign in with Apple
CardinalKit
Docs
Getting StartedResources
Community
GitHubByers Center for BiodesignCommunity
Copyright © 2021 CardinalKit