# aadit-issar/tapform architecture

> Architecture diagram of the GitHub repository aadit-issar/tapform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aadit-issar/tapform
- Repository: https://github.com/aadit-issar/tapform

## Overview

TapForm is a privacy-focused structured Vault and consent-based information-sharing app. Organizations create requests from templates; people receive them through NFC or QR, authenticate, review the requester and purpose, choose fields, and approve or decline. Approved values are resolved and snapshotted server-side, then surfaced to the organization. The README documents Supabase RPC, RLS, and Realtime behavior; sampled client excerpts show review actions and supporting modules, but not the backend schema or full screen implementations.

Main entry points: [`src/app/review.tsx`](https://github.com/aadit-issar/tapform/blob/main/src/app/review.tsx) (Consent review), [`src/services/supabase.ts`](https://github.com/aadit-issar/tapform/blob/main/src/services/supabase.ts) (Supabase client), [`src/services/requests.ts`](https://github.com/aadit-issar/tapform/blob/main/src/services/requests.ts) (Request operations), [`src/app/(tabs)/templates.tsx`](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/templates.tsx) (Request templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["App workflows"]
  node_templates["Request templates<br/>[templates.tsx]"]
  node_vault["Private Vault<br/>[vault.tsx]"]
  node_orgrequest["Request session<br/>[index.tsx]"]
  node_nfcscreen["NFC sharing<br/>[nfc.tsx]"]
  node_qrscan["QR scanning<br/>[scan.tsx]"]
  node_incoming["Incoming request<br/>[incoming.tsx]"]
  node_review["Consent review<br/>[review.tsx]"]
  node_activity["Request activity<br/>[activity.tsx]"]
  node_submissions["Submissions<br/>[submissions.tsx]"]
  node_signin["Authentication<br/>[index.tsx]"]
end

subgraph group_logic["Domain and services"]
  node_fields["Vault field model<br/>[fields.ts]"]
  node_exchange["Exchange rules<br/>[exchange.ts]"]
  node_appstate["App state<br/>[AppState.tsx]"]
  node_requests["Request operations<br/>[requests.ts]"]
  node_schemas["Request schemas<br/>[requestSchemas.ts]"]
  node_pending["Pending review store<br/>[pendingReview.ts]"]
  node_tapcards["Tap card data<br/>[tapCards.ts]"]
  node_ui["Shared UI components<br/>[ui.tsx]"]
  node_motion["Motion primitives"]
end

subgraph group_nfc["NFC transport"]
  node_nfcclient["NFC peer service<br/>[nfcPeer.ts]"]
  node_native["Native NFC module<br/>[NfcPeerModule.kt]"]
  node_protocol["APDU protocol<br/>[NfcProtocol.kt]"]
  node_hce["HCE receiver"]
end

subgraph group_backend["Backend and data"]
  node_supabaseclient["Supabase client<br/>[supabase.ts]"]
  node_database[("Supabase data")]
  node_realtime["Organization updates"]
  node_purge["Expired share purge<br/>[index.ts]"]
end

node_person(("Personal user"))
node_org(("Organization user"))

node_org -->|"selects template"| node_templates
node_templates -.->|"creates session"| node_orgrequest
node_orgrequest -.->|"creates session"| node_supabaseclient
node_orgrequest -.->|"offers NFC"| node_nfcscreen
node_orgrequest -.->|"offers QR"| node_qrscan
node_person -->|"scans request"| node_qrscan
node_person -->|"taps phone"| node_nfcscreen
node_nfcscreen -->|"starts transport"| node_nfcclient
node_qrscan -.->|"joins session"| node_requests
node_nfcclient -->|"bridges NFC"| node_native
node_native -->|"serves APDUs"| node_hce
node_hce -->|"decodes APDUs"| node_protocol
node_native -->|"encodes protocol"| node_protocol
node_incoming -.->|"loads locator"| node_pending
node_incoming -.->|"joins session"| node_requests
node_signin -->|"sets role"| node_appstate
node_person -->|"authenticates"| node_signin
node_requests -->|"calls RPC"| node_supabaseclient
node_requests -->|"validates data"| node_schemas
node_review -->|"submits consent"| node_requests
node_review -->|"clears review"| node_pending
node_review -->|"updates notification"| node_nfcclient
node_review -->|"selects fields"| node_fields
node_review -->|"validates choices"| node_exchange
node_vault -.->|"edits fields"| node_fields
node_appstate -->|"loads profile"| node_supabaseclient
node_appstate -->|"holds Vault"| node_fields
node_activity -->|"loads activity"| node_tapcards
node_activity -->|"loads pending"| node_pending
node_activity -->|"loads requests"| node_requests
node_templates -->|"uses field model"| node_fields
node_templates -->|"reads data"| node_supabaseclient
node_tapcards -->|"uses field model"| node_fields
node_tapcards -->|"reads data"| node_supabaseclient
node_submissions -.->|"reads submissions"| node_supabaseclient
node_supabaseclient -->|"accesses data"| node_database
node_database -->|"publishes updates"| node_realtime
node_purge -.->|"purges expired values"| node_database
node_templates -->|"renders controls"| node_ui
node_review -->|"renders controls"| node_ui
node_review -->|"renders toggles"| node_motion

click node_templates "https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/templates.tsx"
click node_vault "https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/vault.tsx"
click node_orgrequest "https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/index.tsx"
click node_nfcscreen "https://github.com/aadit-issar/tapform/blob/main/src/app/nfc.tsx"
click node_qrscan "https://github.com/aadit-issar/tapform/blob/main/src/app/scan.tsx"
click node_incoming "https://github.com/aadit-issar/tapform/blob/main/src/app/incoming.tsx"
click node_review "https://github.com/aadit-issar/tapform/blob/main/src/app/review.tsx"
click node_activity "https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/activity.tsx"
click node_submissions "https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/submissions.tsx"
click node_signin "https://github.com/aadit-issar/tapform/blob/main/src/app/index.tsx"
click node_fields "https://github.com/aadit-issar/tapform/blob/main/src/domain/fields.ts"
click node_exchange "https://github.com/aadit-issar/tapform/blob/main/src/domain/exchange.ts"
click node_appstate "https://github.com/aadit-issar/tapform/blob/main/src/state/AppState.tsx"
click node_requests "https://github.com/aadit-issar/tapform/blob/main/src/services/requests.ts"
click node_schemas "https://github.com/aadit-issar/tapform/blob/main/src/services/requestSchemas.ts"
click node_pending "https://github.com/aadit-issar/tapform/blob/main/src/services/pendingReview.ts"
click node_tapcards "https://github.com/aadit-issar/tapform/blob/main/src/services/tapCards.ts"
click node_nfcclient "https://github.com/aadit-issar/tapform/blob/main/src/services/nfcPeer.ts"
click node_native "https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt"
click node_protocol "https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcProtocol.kt"
click node_hce "https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt"
click node_supabaseclient "https://github.com/aadit-issar/tapform/blob/main/src/services/supabase.ts"
click node_purge "https://github.com/aadit-issar/tapform/blob/main/supabase/functions/purge-expired-shares/index.ts"
click node_ui "https://github.com/aadit-issar/tapform/blob/main/src/components/ui.tsx"
click node_motion "https://github.com/aadit-issar/tapform/blob/main/src/components/motion/MotionPrimitives.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_templates,node_vault,node_orgrequest,node_nfcscreen,node_qrscan,node_incoming,node_review,node_activity,node_submissions,node_signin,node_person,node_org toneBlue
class node_fields,node_exchange,node_appstate,node_requests,node_schemas,node_pending,node_tapcards,node_ui,node_motion toneAmber
class node_nfcclient,node_native,node_protocol,node_hce toneMint
class node_supabaseclient,node_database,node_realtime,node_purge toneRose
```

## Components

### App workflows

- [Request templates](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/templates.tsx): `src/app/(tabs)/templates.tsx`
- [Private Vault](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/vault.tsx): `src/app/(tabs)/vault.tsx`
- [Request session](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/index.tsx): `src/app/(tabs)/index.tsx`
- [NFC sharing](https://github.com/aadit-issar/tapform/blob/main/src/app/nfc.tsx): `src/app/nfc.tsx`
- [QR scanning](https://github.com/aadit-issar/tapform/blob/main/src/app/scan.tsx): `src/app/scan.tsx`
- [Incoming request](https://github.com/aadit-issar/tapform/blob/main/src/app/incoming.tsx): `src/app/incoming.tsx`
- [Consent review](https://github.com/aadit-issar/tapform/blob/main/src/app/review.tsx): `src/app/review.tsx`
- [Request activity](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/activity.tsx): `src/app/(tabs)/activity.tsx`
- [Submissions](https://github.com/aadit-issar/tapform/blob/main/src/app/(tabs)/submissions.tsx): `src/app/(tabs)/submissions.tsx`
- [Authentication](https://github.com/aadit-issar/tapform/blob/main/src/app/index.tsx): `src/app/index.tsx`

### Domain and services

- [Vault field model](https://github.com/aadit-issar/tapform/blob/main/src/domain/fields.ts): `src/domain/fields.ts`
- [Exchange rules](https://github.com/aadit-issar/tapform/blob/main/src/domain/exchange.ts): `src/domain/exchange.ts`
- [App state](https://github.com/aadit-issar/tapform/blob/main/src/state/AppState.tsx): `src/state/AppState.tsx`
- [Request operations](https://github.com/aadit-issar/tapform/blob/main/src/services/requests.ts): `src/services/requests.ts`
- [Request schemas](https://github.com/aadit-issar/tapform/blob/main/src/services/requestSchemas.ts): `src/services/requestSchemas.ts`
- [Pending review store](https://github.com/aadit-issar/tapform/blob/main/src/services/pendingReview.ts): `src/services/pendingReview.ts`
- [Tap card data](https://github.com/aadit-issar/tapform/blob/main/src/services/tapCards.ts): `src/services/tapCards.ts`
- [Shared UI components](https://github.com/aadit-issar/tapform/blob/main/src/components/ui.tsx): `src/components/ui.tsx`
- [Motion primitives](https://github.com/aadit-issar/tapform/blob/main/src/components/motion/MotionPrimitives.tsx): `src/components/motion/MotionPrimitives.tsx`

### NFC transport

- [NFC peer service](https://github.com/aadit-issar/tapform/blob/main/src/services/nfcPeer.ts): `src/services/nfcPeer.ts`
- [Native NFC module](https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt): `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt`
- [APDU protocol](https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcProtocol.kt): `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcProtocol.kt`
- [HCE receiver](https://github.com/aadit-issar/tapform/blob/main/modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt): `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt`

### Backend and data

- [Supabase client](https://github.com/aadit-issar/tapform/blob/main/src/services/supabase.ts): `src/services/supabase.ts`
- **Supabase data**
- **Organization updates**
- [Expired share purge](https://github.com/aadit-issar/tapform/blob/main/supabase/functions/purge-expired-shares/index.ts): `supabase/functions/purge-expired-shares/index.ts`

### Other components

- **Personal user**
- **Organization user**

## Connections

- Organization user → Request templates: selects template (evidence: `README.md`)
- Request templates → Request session: creates session (evidence: `README.md`)
- Request session → Supabase client: creates session (evidence: `README.md`)
- Request session → NFC sharing: offers NFC (evidence: `README.md`)
- Request session → QR scanning: offers QR (evidence: `README.md`)
- Personal user → QR scanning: scans request (evidence: `README.md`)
- Personal user → NFC sharing: taps phone (evidence: `README.md`)
- NFC sharing → NFC peer service: starts transport
- QR scanning → Request operations: joins session (evidence: `README.md`)
- NFC peer service → Native NFC module: bridges NFC (evidence: `src/services/nfcPeer.ts`)
- Native NFC module → HCE receiver: serves APDUs (evidence: `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt`)
- HCE receiver → APDU protocol: decodes APDUs (evidence: `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt`)
- Native NFC module → APDU protocol: encodes protocol (evidence: `modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt`)
- Incoming request → Pending review store: loads locator (evidence: `README.md`)
- Incoming request → Request operations: joins session (evidence: `README.md`)
- Authentication → App state: sets role (evidence: `src/app/index.tsx`)
- Personal user → Authentication: authenticates (evidence: `README.md`)
- Request operations → Supabase client: calls RPC (evidence: `src/services/requests.ts`)
- Request operations → Request schemas: validates data (evidence: `src/services/requests.ts`)
- Consent review → Request operations: submits consent (evidence: `src/app/review.tsx`)
- Consent review → Pending review store: clears review (evidence: `src/app/review.tsx`)
- Consent review → NFC peer service: updates notification (evidence: `src/app/review.tsx`)
- Consent review → Vault field model: selects fields (evidence: `src/app/review.tsx`)
- Consent review → Exchange rules: validates choices (evidence: `src/app/review.tsx`)
- Private Vault → Vault field model: edits fields (evidence: `README.md`)
- App state → Supabase client: loads profile (evidence: `src/state/AppState.tsx`)
- App state → Vault field model: holds Vault (evidence: `src/state/AppState.tsx`)
- Request activity → Tap card data: loads activity (evidence: `src/app/(tabs)/activity.tsx`)
- Request activity → Pending review store: loads pending (evidence: `src/app/(tabs)/activity.tsx`)
- Request activity → Request operations: loads requests (evidence: `src/app/(tabs)/activity.tsx`)
- Request templates → Vault field model: uses field model (evidence: `src/app/(tabs)/templates.tsx`)
- Request templates → Supabase client: reads data (evidence: `src/app/(tabs)/templates.tsx`)
- Tap card data → Vault field model: uses field model (evidence: `src/services/tapCards.ts`)
- Tap card data → Supabase client: reads data (evidence: `src/services/tapCards.ts`)
- Submissions → Supabase client: reads submissions (evidence: `README.md`)
- Supabase client → Supabase data: accesses data (evidence: `README.md`)
- Supabase data → Organization updates: publishes updates (evidence: `README.md`)
- Expired share purge → Supabase data: purges expired values (evidence: `README.md`)
- Request templates → Shared UI components: renders controls (evidence: `src/app/(tabs)/templates.tsx`)
- Consent review → Shared UI components: renders controls (evidence: `src/app/review.tsx`)
- Consent review → Motion primitives: renders toggles (evidence: `src/app/review.tsx`)
