Skip to Content
Platform.Ontology

Data model

Every field, the 7 kinds, 24 groups, lifecycle stages, reach levels, scores and status codes.

Every capability is one JSON object checked by schema/capability.schema.json. This page explains each field and every fixed list of values.

Fields

FieldWhat it holds
idStable id. mob.* for native apps (Android and iPhone), web.* for websites. Never reused.
nameA short plain name.
plainOne plain sentence about what it is.
meaningWhy it matters, in a few sentences.
kindOne of the 7 kinds below.
group, subgroupOne of the 24 groups below, plus a finer label inside it.
spacemobile or web. Matches the folder.
tagsShort search words.
lifecycleWhen it happens. A list of stages from the table below.
platformsThe facts that differ per platform. See below.
dataWhat comes back: type, metric, update rate and a fields list with name, type, unit, range and precision.
limitsThe plain bounds: headline, user_action, can, cannot, reach, reach_label, differs.
storyReader friendly text: what_it_is, a Lucide icon name, for_you, for_makers, use_cases, risks, vendor marketing links and short android_note and ios_note.
technical_boundsHard technical limits, for example "Only works on cameras that advertise it".
scoressensitivity, utility, friction and fingerprint_bits.
valuelegit_uses and known abuse.
case_studyA real example. Currently a LinkedIn note when the capability is used there.
historyDated platform changes, each with date, the OS or browser, version and change.
relatedIds of related capabilities.
web_equivalentsIds of the same idea on the other side (native or web).
refsSources, each with a type t, a label and a url.
confidenceverified, docs or inferred. How well the facts were checked.

Native platform block

For mob.* capabilities, platforms.android and platforms.ios hold:

FieldMeaning
sStatus code, see below.
vFirst OS version that has it.
apiAndroid API level (Android only).
permissionThe permission string, entitlement or Info.plist key.
protectionThe protection level, for example normal, dangerous, signature or entitlement.
grantHow access is granted: none, install, prompt, settings, picker, role, enterprise, system-only or not-exposed.
prompt_uiWhat the user sees.
persistenceHow long the grant lasts.
revocationWhere the user takes it back.
store_policyAny App Store or Google Play rule that applies.
api_surfaceThe API or file involved.
noteAnything else worth knowing.

Web platform block

For web.* capabilities, platforms.web holds:

FieldMeaning
apiThe API call or feature a site uses.
permission_nameThe name used by the Permissions API, when there is one.
permissions_policyThe Permissions Policy directive that controls it in iframes.
bcdKeys in the MDN browser compatibility data.
accessgrant, prompt_ui, secure_context, user_gesture, activation, persistence, revocation, iframe and a list of steps.
supportOne record per browser, each with s, v, note and sometimes date.

The 7 kinds

Kinds say how a capability behaves for the person using the device.

LabelKeyMeaning
Asks you firstpermissionA pop up asks for your OK before the app gets it.
You pick what to sharepickerYou choose the exact items (a photo, a file, a contact).
Works without askingcapabilityA useful feature apps can just use. No pop up.
Does something on your deviceactionMakes the device act: vibrate, share, keep the screen on.
Gets silentlysignalA detail about you or your device that apps can get with no prompt.
Used to track youtrackingMostly used to follow you across apps, sites or ads.
Blocked for appsnot-exposedApps can't get this, or it was taken away from them.

The 24 groups

Groups sort capabilities by topic. Native apps use 22 of them and the web uses 19.

LabelKeyCovers
Location and motionlocation-motionWhere you are and how you move
Camera, mic and screencamera-mic-screenSeeing, hearing and recording
Contacts and personal datapersonal-data-contactsYour people, photos, calendar and more
Health and fitnesshealth-fitnessSteps, heart rate, workouts, health records
Sign in and identityidentity-authFace ID, passkeys, accounts and logins
Payments and shoppingpayments-commercePaying, wallets and purchases
Notifications and backgroundnotifications-backgroundAlerts and work that runs when the app is closed
Files and storagefiles-storageSaving, opening and keeping data
Hardware and accessoriesperipherals-hardwareBluetooth, USB, NFC, controllers, sensors
Network and connectionnetwork-connectivityWi-Fi, cell signal, internet speed
Device detailsdevice-system-profileModel, memory, battery and other facts about the device
Screen and windowsdisplay-windowScreen size, brightness, full screen, windows
Typing and clipboardinput-clipboardKeyboard, copy and paste, touch and mouse
Language and settingslocale-preferencesLanguage, time zone, dark mode, text size
Speed and timingtiming-performanceHow fast things load and run
On-device AIon-device-aiAI that runs right on your device
Home screen and system linksos-integration-installInstalling, widgets, shortcuts, sharing
System controlsystem-controlChanging device settings and controlling other apps
Calls and textstelephony-smsPhone calls, SMS and carrier details
Other apps on the phoneapp-ecosystemSeeing and talking to other installed apps
Ads and install trackingattribution-adsMeasuring which ad led to an install or sale
Tracking across apps and sitescross-site-trackingIDs and tricks that follow you around
Graphics and fingerprintingrendering-fingerprintDrawing and the hidden device clues it leaks
Things a page can dopage-actionsActions a website can take for you

Lifecycle stages

Lifecycle says when a capability can happen. A capability can have more than one stage.

KeyLabel
before-installBefore you install
before-visitBefore you visit
on-launchWhen the app opens
on-arrivalWhen the page loads
in-sessionWhile you use it
backgroundIn the background
signed-inWhen you are signed in
after-leavingAfter you leave the site
after-uninstallAfter you uninstall

Reach

Reach is a 1 to 4 scale for how much a capability can touch.

LevelMeaning
1One thing, one moment
2While you use it, or only what you choose
3Ongoing or in the background, one kind of data
4Broad: everything of that type, anytime

Pages show it as a four step meter next to a plain label such as "One camera, while you use the site".

Scores

ScoreScaleMeaning
sensitivity1 to 5How revealing the data is
utility1 to 5How useful it is to honest apps
friction0 to 5How much the user has to do. 0 means nothing at all.
fingerprint_bitsnumber or emptyRough bits of identifying information, when known

Status codes

Status is used per platform (s) and per browser (support.<browser>.s).

CodeMeaning
ySupported
pPartial or behind a flag
nNot supported
rRemoved
fBehind a preference flag only (a few web records use this)

Platforms and browsers

The platform keys are android (Android), ios (iPhone) and web. Browser keys inside web support are chrome, edge, firefox, safari, ios_safari (Safari on iPhone), chrome_android (Chrome on Android) and samsung (Samsung Internet).

Confidence

ValueMeaning
verifiedChecked against real behavior
docsBased on official documentation
inferredInferred from related behavior; welcome for review

On this page