This repository holds connectors that collect a person's own data from a platform, such as an API, a signed-in website or an exported file, and emit it as records in the format of the PDPP Collection Profile. Each connector is a directory in connectors/. The runtime and tools they share are in packages/polyfill-connectors/.
- Follow AUTHORING.md. It takes you from install to an open PR, step by step, and says how to choose each manifest setting.
- For a browser connector, also follow the browser connector guidelines. They say what works in the desktop app and in the mobile app.
- Sign off each commit with
git commit -s. If AI helped with a commit, add anAssisted-by: AItrailer. CONTRIBUTING.md gives the full policy.
A maintainer reviews the PR against CONNECTOR-REVIEW.md. Coding agents start at AGENTS.md.
| You want to | Read |
|---|---|
| Look up a rule for runtime, schemas or capture | Connector authoring guide |
| Look up what each evidence tier needs | Connector checklist |
| Add a connector to the mobile app | docs/add-a-connector-to-mobile.md |
| Run the test suites | TESTING.md |
| Learn how connectors are versioned and published | docs/publishing.md |
| Review, merge and publish a connector PR | CONNECTOR-REVIEW.md |