How aadit-issar/tapform works
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: review.tsx Consent review · supabase.ts Supabase client · requests.ts Request operations · templates.tsx Request templates
Components 29
App workflows
- Request templates
src/app/(tabs)/templates.tsx - Private Vault
src/app/(tabs)/vault.tsx - Request session
src/app/(tabs)/index.tsx - NFC sharing
src/app/nfc.tsx - QR scanning
src/app/scan.tsx - Incoming request
src/app/incoming.tsx - Consent review
src/app/review.tsx - Request activity
src/app/(tabs)/activity.tsx - Submissions
src/app/(tabs)/submissions.tsx - Authentication
src/app/index.tsx
Domain and services
- Vault field model
src/domain/fields.ts - Exchange rules
src/domain/exchange.ts - App state
src/state/AppState.tsx - Request operations
src/services/requests.ts - Request schemas
src/services/requestSchemas.ts - Pending review store
src/services/pendingReview.ts - Tap card data
src/services/tapCards.ts - Shared UI components
src/components/ui.tsx - Motion primitives
src/components/motion/MotionPrimitives.tsx
NFC transport
- NFC peer service
src/services/nfcPeer.ts - Native NFC module
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt - APDU protocol
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcProtocol.kt - HCE receiver
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt
Backend and data
- Supabase client
src/services/supabase.ts - Supabase data
- Organization updates
- Expired share purge
supabase/functions/purge-expired-shares/index.ts
Other components
- Personal user
- Organization user
Connections 41
- Organization user → Request templates: selects template
README.md - Request templates → Request session: creates session
README.md - Request session → Supabase client: creates session
README.md - Request session → NFC sharing: offers NFC
README.md - Request session → QR scanning: offers QR
README.md - Personal user → QR scanning: scans request
README.md - Personal user → NFC sharing: taps phone
README.md - NFC sharing → NFC peer service: starts transport
- QR scanning → Request operations: joins session
README.md - NFC peer service → Native NFC module: bridges NFC
src/services/nfcPeer.ts - Native NFC module → HCE receiver: serves APDUs
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt - HCE receiver → APDU protocol: decodes APDUs
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/TapFormApduService.kt - Native NFC module → APDU protocol: encodes protocol
modules/nfc-peer/android/src/main/java/expo/modules/nfcpeer/NfcPeerModule.kt - Incoming request → Pending review store: loads locator
README.md - Incoming request → Request operations: joins session
README.md - Authentication → App state: sets role
src/app/index.tsx - Personal user → Authentication: authenticates
README.md - Request operations → Supabase client: calls RPC
src/services/requests.ts - Request operations → Request schemas: validates data
src/services/requests.ts - Consent review → Request operations: submits consent
src/app/review.tsx - Consent review → Pending review store: clears review
src/app/review.tsx - Consent review → NFC peer service: updates notification
src/app/review.tsx - Consent review → Vault field model: selects fields
src/app/review.tsx - Consent review → Exchange rules: validates choices
src/app/review.tsx - Private Vault → Vault field model: edits fields
README.md - App state → Supabase client: loads profile
src/state/AppState.tsx - App state → Vault field model: holds Vault
src/state/AppState.tsx - Request activity → Tap card data: loads activity
src/app/(tabs)/activity.tsx - Request activity → Pending review store: loads pending
src/app/(tabs)/activity.tsx - Request activity → Request operations: loads requests
src/app/(tabs)/activity.tsx - Request templates → Vault field model: uses field model
src/app/(tabs)/templates.tsx - Request templates → Supabase client: reads data
src/app/(tabs)/templates.tsx - Tap card data → Vault field model: uses field model
src/services/tapCards.ts - Tap card data → Supabase client: reads data
src/services/tapCards.ts - Submissions → Supabase client: reads submissions
README.md - Supabase client → Supabase data: accesses data
README.md - Supabase data → Organization updates: publishes updates
README.md - Expired share purge → Supabase data: purges expired values
README.md - Request templates → Shared UI components: renders controls
src/app/(tabs)/templates.tsx - Consent review → Shared UI components: renders controls
src/app/review.tsx - Consent review → Motion primitives: renders toggles
src/app/review.tsx