Whether You Need Rork Max Is Answered by Your Permissions, Not the Price Page

#!/usr/bin/env node
// capability-inventory.mjs
// Lists the OS capabilities an Expo project actually requests and sorts them into A/B/C.
// Usage: node capability-inventory.mjs [project root]
 
import { readFileSync, existsSync } from "node:fs";
import { join } from "node:path";
 
const root = process.argv[2] ?? ".";
 
// Only things you cannot build without leaving Expo belong in column C.
const RULES = [
  ["UIBackgroundModes:audio", "B", "expo-av / expo-audio plus the background mode declaration"],
  ["UIBackgroundModes:remote-notification", "A", "within expo-notifications"],
  ["UIBackgroundModes:processing", "B", "BGTaskScheduler via expo-background-task"],
  ["UIBackgroundModes:location", "B", "needs expo-location background permission"],
  ["NSMicrophoneUsageDescription", "A", "recording works with expo-av / expo-audio"],
  ["NSCameraUsageDescription", "A", "within expo-camera"],
  ["NSPhotoLibraryAddUsageDescription", "A", "saving works with expo-media-library"],
  ["NSPhotoLibraryUsageDescription", "A", "within expo-media-library"],
  ["NSLocationWhenInUseUsageDescription", "A", "within expo-location"],
  ["NSFaceIDUsageDescription", "A", "within expo-local-authentication"],
  ["NSHealthShareUsageDescription", "C", "HealthKit lives outside Expo"],
  ["NSHomeKitUsageDescription", "C", "HomeKit lives outside Expo"],
  ["NFCReaderUsageDescription", "C", "Core NFC lives outside Expo"],
  ["LSApplicationQueriesSchemes", "A", "a declaration for Linking.canOpenURL"],
  ["aps-environment", "A", "push notification certificate setting"],
  ["com.apple.developer.applesignin", "A", "within expo-apple-authentication"],
  ["com.apple.developer.associated-domains", "B", "writable from a config plugin"],
  ["com.apple.developer.healthkit", "C", "HealthKit lives outside Expo"],
  ["com.apple.developer.homekit", "C", "HomeKit lives outside Expo"],
  ["com.apple.developer.usernotifications.time-sensitive", "B", "reachable through configuration"],
  ["com.apple.developer.group-session", "C", "SharePlay lives outside Expo"],
  ["com.apple.developer.family-controls", "C", "Screen Time API lives outside Expo"],
  ["widget", "C", "Widgets and Live Activities need a separate target"],
  ["ActivityKit", "C", "Live Activities need a separate target"],
];
 
function classify(key) {
  const hit = RULES.find((r) => key.toLowerCase().includes(r[0].toLowerCase()));
  return hit
    ? { col: hit[1], note: hit[2] }
    : { col: "?", note: "no rule yet — decide this one by hand" };
}
 
function readJson(path) {
  if (!existsSync(path)) return null;
  try {
    return JSON.parse(readFileSync(path, "utf8"));
  } catch (e) {
    console.error(`x could not read ${path}: ${e.message}`);
    return null;
  }
}
 
const appJson =
  readJson(join(root, "app.json")) ?? readJson(join(root, "app.config.json"));
const pkg = readJson(join(root, "package.json"));
 
if (!appJson) {
  console.error("No app.json here. If you use app.config.js, run");
  console.error("  npx expo config --type public --json > app.json.tmp");
  console.error("and point this script at that temporary file instead.");
  process.exit(1);
}
 
const expo = appJson.expo ?? appJson;
const info = expo.ios?.infoPlist ?? {};
const ent = expo.ios?.entitlements ?? {};
const rows = [];
 
// (1) Info.plist purpose strings. An empty value is a leftover declaration.
for (const [k, v] of Object.entries(info)) {
  if (k === "UIBackgroundModes") {
    for (const mode of v ?? [])
      rows.push({ key: `UIBackgroundModes:${mode}`, source: "ios.infoPlist", empty: false });
    continue;
  }
  const empty =
    typeof v === "string" ? v.trim() === "" : Array.isArray(v) ? v.length === 0 : false;
  rows.push({ key: k, source: "ios.infoPlist", empty });
}
 
// (2) entitlements
for (const k of Object.keys(ent)) {
  rows.push({ key: k, source: "ios.entitlements", empty: false });
}
 
// (3) Android permissions, useful for cross-checking the iOS side
for (const p of expo.android?.permissions ?? []) {
  rows.push({
    key: p.replace("android.permission.", "ANDROID:"),
    source: "android.permissions",
    empty: false,
  });
}
 
const bucket = { A: [], B: [], C: [], "?": [] };
for (const r of rows) {
  const { col, note } =
    r.source === "android.permissions"
      ? { col: "A", note: "declared on the Android side" }
      : classify(r.key);
  bucket[col].push({ ...r, note });
}
 
console.log(`# capability inventory — ${expo.name ?? "(no name set)"}`);
console.log(
  `# ${rows.length} found / A ${bucket.A.length} · B ${bucket.B.length} · C ${bucket.C.length} · unsorted ${bucket["?"].length}\n`
);
 
for (const col of ["C", "B", "A", "?"]) {
  if (bucket[col].length === 0) continue;
  console.log(`[${col}]`);
  for (const r of bucket[col]) {
    const flag = r.empty ? "  <- empty value; a candidate for removal" : "";
    console.log(`  ${r.key}  (${r.source})  ${r.note}${flag}`);
  }
  console.log("");
}
 
if (pkg) {
  const natives = Object.keys(pkg.dependencies ?? {}).filter(
    (d) => d.startsWith("expo-") || d.startsWith("react-native-") || d === "react-native"
  );
  console.log(`[reference] ${natives.length} dependencies that may carry native code`);
  console.log("  " + natives.join(", "));
}
 
// Exit 2 when column C has anything, so CI can notice.
process.exit(bucket.C.length > 0 ? 2 : 0);

# capability inventory — AmbientSleep
# 10 found / A 9 · B 1 · C 0 · unsorted 0
 
[B]
  UIBackgroundModes:audio  (ios.infoPlist)  expo-av / expo-audio plus the background mode declaration
 
[A]
  UIBackgroundModes:remote-notification  (ios.infoPlist)  within expo-notifications
  NSMicrophoneUsageDescription  (ios.infoPlist)  recording works with expo-av / expo-audio
  NSPhotoLibraryAddUsageDescription  (ios.infoPlist)  saving works with expo-media-library
  NSCameraUsageDescription  (ios.infoPlist)  within expo-camera  <- empty value; a candidate for removal
  LSApplicationQueriesSchemes  (ios.infoPlist)  a declaration for Linking.canOpenURL
  com.apple.developer.applesignin  (ios.entitlements)  within expo-apple-authentication
  aps-environment  (ios.entitlements)  push notification certificate setting
  ANDROID:POST_NOTIFICATIONS  (android.permissions)  declared on the Android side
  ANDROID:RECORD_AUDIO  (android.permissions)  declared on the Android side
 
[reference] 5 dependencies that may carry native code
  expo-av, expo-notifications, react-native, react-native-google-mobile-ads, react-native-purchases

# capability inventory — SleepCoach
# 7 found / A 2 · B 3 · C 2 · unsorted 0
 
[C]
  NSHealthShareUsageDescription  (ios.infoPlist)  HealthKit lives outside Expo
  com.apple.developer.healthkit  (ios.entitlements)  HealthKit lives outside Expo
 
[B]
  UIBackgroundModes:audio  (ios.infoPlist)  expo-av / expo-audio plus the background mode declaration
  UIBackgroundModes:processing  (ios.infoPlist)  BGTaskScheduler via expo-background-task
  com.apple.developer.associated-domains  (ios.entitlements)  writable from a config plugin

// plugins/with-background-audio.js
// A minimal config plugin that adds UIBackgroundModes in a prebuild-safe way.
const { withInfoPlist } = require("expo/config-plugins");
 
module.exports = function withBackgroundAudio(config) {
  return withInfoPlist(config, (cfg) => {
    const modes = new Set(cfg.modResults.UIBackgroundModes ?? []);
    modes.add("audio");
    cfg.modResults.UIBackgroundModes = [...modes];
    return cfg;
  });
};

// The declaration on the app.json side — just append to the array.
{
  "expo": {
    "plugins": ["./plugins/with-background-audio"]
  }
}

# docs/decisions/2026-09-08-rork-max.yaml
date: 2026-09-08
question: Move to Rork Max, or stay on standard Rork?
inventory:
  a: 9
  b: 1
  c: 0
  unknown: 0
c_items: []
decision: Stay on standard Rork
reason: |
  Column C is empty. Background playback landed in B (config plugin plus the
  background mode declaration). The monthly difference buys a build environment
  rather than a capability, and for now I would rather own that myself.
revisit_when:
  - A Widget or Live Activity becomes central to the product
  - Several reviews actually ask for HealthKit integration