CardinalKit

CardinalKit

  • Docs
  • Community
  • Resources
  • Blog

›Reference

Getting Started

  • Generate CardinalKit App
  • Set Up Application Infrastructure

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 Permissions TextSubtext for requesting health permisions
Background Read Frequencyimmediate, hourly, daily, or weekly: How often to read from HealthKit data records
Sign in with AppleSee below
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
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 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 (YES or NO)
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.

← Set Up Application InfrastructureContributing 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 © 2020 CardinalKit