# Rollup

> Rollup is an on-device camera roll analysis SDK for iOS apps. With the person's permission it indexes the photos, screenshots and videos on their iPhone, and the app can search that index on the device, ask a question about the person's life, or fill a JSON Schema with structured context for personalized onboarding and recommendations. The photos stay on the phone.

Facts

- Runs on iPhones with iOS 26 or later. An app can target iOS 16 and offer the feature on 26 and up. It does not run in the iOS Simulator.
- Install with Swift Package Manager or CocoaPods from https://github.com/tryrollup/rollup-ios-sdk, or in Expo and React Native apps with the expo-rollup module on npm.
- Three calls. search runs on the device with a natural-language query and sends nothing. query answers a question about the person's life. profile fills a JSON Schema the app writes, every field with the photos behind it as evidence. query and profile run an agent on Rollup's server whose tools run on the iPhone.
- What leaves the phone, for query and profile: the question or schema and the text the index derived (dates, places, labels, text read from images). Rollup stores none of it. Photos, videos and the index stay on the iPhone.
- Permission: the person turns the feature on inside the app and grants Photos access through the iOS prompt. Before the first query or profile, the app tells them what is sent to Rollup and asks their permission (App Store Review Guideline 5.1.2(i)). reset() deletes everything the SDK keeps on the iPhone and the device's record on Rollup's server.
- Rollup does not fill profile fields about health, religion, sexuality, ethnicity or race, politics, or children, and marks photos of IDs, health documents and other sensitive content on the iPhone so they stay out of answers.
- Measured on one iPhone 16 Pro Max on October 10, 2026: 14 s to first results, 4 min to index three months of photos, 0.09 Wh of battery for that index.
- Plugs into the onboarding, ranking or recommendation system an app already has. profile returns JSON in the shape of the app's schema, so its fields go wherever the app already reads user attributes.
- Used for cold-start personalization (a new user's first session, onboarding and recommendations from what their photos already say), intent from screenshots (products, places and events a person saved), and filling the gaps between visits.
- Developer access: https://www.tryrollup.com/developers. Contact: founders@tryrollup.com.

## Docs

- [Full documentation in one file](https://docs.tryrollup.com/llms-full.txt): every page of the developer docs, for agents
- [Docs index](https://docs.tryrollup.com/llms.txt): one line per docs page
- [Quickstart](https://docs.tryrollup.com/quickstart.md): access, install, Info.plist, App Attest, first search, query and profile; includes a setup prompt to hand a coding agent
- [Requirements](https://docs.tryrollup.com/requirements.md): devices, Xcode, supporting iOS before 26
- [Profile](https://docs.tryrollup.com/guides/profile.md): JSON Schema in, filled profile with evidence out, sensitive fields, limits
- [Query](https://docs.tryrollup.com/guides/query.md): ask a question about the person's life
- [Search](https://docs.tryrollup.com/guides/search.md): search the camera roll on the iPhone
- [Background indexing](https://docs.tryrollup.com/guides/background-indexing.md): how indexing starts, continues in the background and stays current
- [Privacy and App Review](https://docs.tryrollup.com/guides/privacy.md): what leaves the iPhone, what to tell the person, what to declare to Apple, deletion
- [Expo and React Native](https://docs.tryrollup.com/platforms/expo.md): the expo-rollup module and its config plugin
- [Swift API overview](https://docs.tryrollup.com/reference/overview.md): every public type and method

## Code

- [rollup-ios-sdk on GitHub](https://github.com/tryrollup/rollup-ios-sdk): Package.swift, Rollup.podspec, README
- [expo-rollup on npm](https://www.npmjs.com/package/expo-rollup): the Expo and React Native module

## Site

- [Home](https://www.tryrollup.com/): what Rollup is, how it works, what an app gets by vertical, privacy, questions
- [Rollup Passport](https://www.tryrollup.com/passport): the iPhone app that writes what a person loves from their photos into one Passport that Claude, ChatGPT and other AI apps can read, with the person's permission
- [Privacy Policy](https://www.tryrollup.com/privacy)
- [SDK Terms](https://www.tryrollup.com/legal/sdk-terms)

## Optional

- [Changelog](https://docs.tryrollup.com/changelog.md): what changed in each release of the SDK