# msarkrish/namma_wallet architecture

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

- Interactive diagram: https://gitdiagram.com/msarkrish/namma_wallet
- Repository: https://github.com/msarkrish/namma_wallet

## Overview

Namma Wallet’s main workflow is accepting ticket material, extracting ticket details, and presenting saved tickets. The README documents SMS, PDF, image, QR, clipboard, and Apple Wallet pass imports, but the Flutter `lib/src` implementation is absent from the supplied tree, so those components have no source paths and their internal call graph is not asserted. The repository also contains Android and iOS ticket widgets and a separate screenshot-design editor. Widget links shown below are limited to relationships visible in excerpts; the screenshot editor’s component links are supported by the source index.

Main entry points: [`app-store-screenshots/src/components/editor/screenshot-editor.tsx`](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/screenshot-editor.tsx) (Screenshot editor), [`app-store-screenshots/src/components/editor/slide-canvas.tsx`](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/slide-canvas.tsx) (Slide canvas), [`android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt`](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt) (Pinned ticket widget), [`android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt`](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt) (Ticket list widget)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ticket_flow["Ticket management"]
  node_ticket_inputs["Ticket inputs"]
  node_sms_import["SMS import"]
  node_pdf_import["PDF import"]
  node_image_import["Image import"]
  node_qr_import["QR scanning"]
  node_clipboard_import["Clipboard import"]
  node_pass_import["Pass import"]
  node_ticket_parsing["Ticket parsing"]
  node_ticket_data["Ticket data"]
  node_ticket_storage[("Ticket storage")]
  node_ticket_views["Ticket views"]
  node_calendar_events["Calendar"]
  node_export["Data export"]
end

subgraph group_platform_widgets["Platform widgets"]
  node_android_main_widget["Pinned ticket widget"]
  node_android_list_widget["Ticket list widget"]
  node_android_widget_service["Widget service"]
  node_android_widget_factory["Widget factory"]
  node_ios_sms_intent["SMS intent"]
  node_ios_app_delegate["iOS app bridge<br/>[AppDelegate.swift]"]
  node_ios_ticket_widget["iOS ticket widget<br/>[TicketWidget.swift]"]
end

subgraph group_screenshot_tool["Screenshot editor"]
  node_screenshot_editor["Screenshot editor"]
  node_editor_inspector["Slide inspector<br/>[inspector.tsx]"]
  node_preview_stage["Preview stage<br/>[preview-stage.tsx]"]
  node_slide_canvas["Slide canvas<br/>[slide-canvas.tsx]"]
  node_device_frames["Device frames<br/>[device-frames.tsx]"]
  node_project_storage["Project state<br/>[storage.ts]"]
  node_project_api["Project API<br/>[route.ts]"]
  node_upload_api["Upload API<br/>[route.ts]"]
end

node_traveler(("Traveler"))

node_traveler -->|"provides material"| node_ticket_inputs
node_ticket_inputs -->|"can enter as SMS"| node_sms_import
node_ticket_inputs -->|"can enter as PDF"| node_pdf_import
node_ticket_inputs -->|"can enter as image"| node_image_import
node_ticket_inputs -->|"can enter by scan"| node_qr_import
node_ticket_inputs -->|"can enter as text"| node_clipboard_import
node_ticket_inputs -->|"can enter as pass"| node_pass_import
node_sms_import -->|"extracts details"| node_ticket_parsing
node_pdf_import -->|"extracts details"| node_ticket_parsing
node_image_import -->|"extracts details"| node_ticket_parsing
node_qr_import -->|"extracts details"| node_ticket_parsing
node_clipboard_import -->|"extracts details"| node_ticket_parsing
node_pass_import -->|"extracts fields"| node_ticket_parsing
node_ticket_parsing -->|"produces tickets"| node_ticket_data
node_ticket_data -->|"organizes tickets"| node_ticket_storage
node_ticket_storage -->|"supplies tickets"| node_ticket_views
node_ticket_storage -->|"supplies events"| node_calendar_events
node_ticket_storage -->|"provides data"| node_export
node_android_main_widget -->|"updates widgets"| node_android_list_widget
node_android_main_widget -->|"reads ticket list"| node_android_widget_factory
node_android_list_widget -->|"sets remote adapter"| node_android_widget_service
node_android_widget_service -->|"creates factory"| node_android_widget_factory
node_ios_sms_intent -->|"enqueues SMS"| node_ios_app_delegate
node_screenshot_editor -->|"uses inspector"| node_editor_inspector
node_screenshot_editor -->|"uses preview"| node_preview_stage
node_screenshot_editor -->|"uses canvas"| node_slide_canvas
node_preview_stage -->|"renders canvas"| node_slide_canvas
node_slide_canvas -->|"renders frames"| node_device_frames
node_project_storage -->|"fetches project"| node_project_api

click node_android_main_widget "https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt"
click node_android_list_widget "https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt"
click node_android_widget_service "https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetService.kt"
click node_android_widget_factory "https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetFactory.kt"
click node_ios_sms_intent "https://github.com/msarkrish/namma_wallet/blob/main/ios/Runner/EnqueueSMSIntent.swift"
click node_ios_app_delegate "https://github.com/msarkrish/namma_wallet/blob/main/ios/Runner/AppDelegate.swift"
click node_ios_ticket_widget "https://github.com/msarkrish/namma_wallet/blob/main/ios/TicketWidget/TicketWidget.swift"
click node_screenshot_editor "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/screenshot-editor.tsx"
click node_editor_inspector "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/inspector.tsx"
click node_preview_stage "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/preview-stage.tsx"
click node_slide_canvas "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/slide-canvas.tsx"
click node_device_frames "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/device-frames.tsx"
click node_project_storage "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/lib/storage.ts"
click node_project_api "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/app/api/project/route.ts"
click node_upload_api "https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/app/api/upload/route.ts"

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_ticket_inputs,node_sms_import,node_pdf_import,node_image_import,node_qr_import,node_clipboard_import,node_pass_import,node_ticket_parsing,node_ticket_data,node_ticket_storage,node_ticket_views,node_calendar_events,node_export toneBlue
class node_android_main_widget,node_android_list_widget,node_android_widget_service,node_android_widget_factory,node_ios_sms_intent,node_ios_app_delegate,node_ios_ticket_widget toneAmber
class node_screenshot_editor,node_editor_inspector,node_preview_stage,node_slide_canvas,node_device_frames,node_project_storage,node_project_api,node_upload_api toneMint
class node_traveler toneIndigo
```

## Components

### Ticket management

- **Ticket inputs**
- **SMS import**
- **PDF import**
- **Image import**
- **QR scanning**
- **Clipboard import**
- **Pass import**
- **Ticket parsing**
- **Ticket data**
- **Ticket storage**
- **Ticket views**
- **Calendar**
- **Data export**

### Platform widgets

- [Pinned ticket widget](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt): `android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt`
- [Ticket list widget](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt): `android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt`
- [Widget service](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetService.kt): `android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetService.kt`
- [Widget factory](https://github.com/msarkrish/namma_wallet/blob/main/android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetFactory.kt): `android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetFactory.kt`
- [SMS intent](https://github.com/msarkrish/namma_wallet/blob/main/ios/Runner/EnqueueSMSIntent.swift): `ios/Runner/EnqueueSMSIntent.swift`
- [iOS app bridge](https://github.com/msarkrish/namma_wallet/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`
- [iOS ticket widget](https://github.com/msarkrish/namma_wallet/blob/main/ios/TicketWidget/TicketWidget.swift): `ios/TicketWidget/TicketWidget.swift`

### Screenshot editor

- [Screenshot editor](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/screenshot-editor.tsx): `app-store-screenshots/src/components/editor/screenshot-editor.tsx`
- [Slide inspector](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/inspector.tsx): `app-store-screenshots/src/components/editor/inspector.tsx`
- [Preview stage](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/preview-stage.tsx): `app-store-screenshots/src/components/editor/preview-stage.tsx`
- [Slide canvas](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/slide-canvas.tsx): `app-store-screenshots/src/components/editor/slide-canvas.tsx`
- [Device frames](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/components/editor/device-frames.tsx): `app-store-screenshots/src/components/editor/device-frames.tsx`
- [Project state](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/lib/storage.ts): `app-store-screenshots/src/lib/storage.ts`
- [Project API](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/app/api/project/route.ts): `app-store-screenshots/src/app/api/project/route.ts`
- [Upload API](https://github.com/msarkrish/namma_wallet/blob/main/app-store-screenshots/src/app/api/upload/route.ts): `app-store-screenshots/src/app/api/upload/route.ts`

### Other components

- **Traveler**

## Connections

- Traveler → Ticket inputs: provides material
- Ticket inputs → SMS import: can enter as SMS
- Ticket inputs → PDF import: can enter as PDF
- Ticket inputs → Image import: can enter as image
- Ticket inputs → QR scanning: can enter by scan
- Ticket inputs → Clipboard import: can enter as text
- Ticket inputs → Pass import: can enter as pass
- SMS import → Ticket parsing: extracts details
- PDF import → Ticket parsing: extracts details
- Image import → Ticket parsing: extracts details
- QR scanning → Ticket parsing: extracts details
- Clipboard import → Ticket parsing: extracts details
- Pass import → Ticket parsing: extracts fields
- Ticket parsing → Ticket data: produces tickets
- Ticket data → Ticket storage: organizes tickets
- Ticket storage → Ticket views: supplies tickets
- Ticket storage → Calendar: supplies events
- Ticket storage → Data export: provides data
- Pinned ticket widget → Ticket list widget: updates widgets (evidence: `android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt`)
- Pinned ticket widget → Widget factory: reads ticket list (evidence: `android/app/src/main/java/com/nammaflutter/nammawallet/MainTicketWidgetProvider.kt`)
- Ticket list widget → Widget service: sets remote adapter (evidence: `android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetProvider.kt`)
- Widget service → Widget factory: creates factory (evidence: `android/app/src/main/java/com/nammaflutter/nammawallet/TicketListWidgetService.kt`)
- SMS intent → iOS app bridge: enqueues SMS (evidence: `ios/Runner/EnqueueSMSIntent.swift`)
- Screenshot editor → Slide inspector: uses inspector (evidence: `app-store-screenshots/src/components/editor/screenshot-editor.tsx`)
- Screenshot editor → Preview stage: uses preview (evidence: `app-store-screenshots/src/components/editor/screenshot-editor.tsx`)
- Screenshot editor → Slide canvas: uses canvas (evidence: `app-store-screenshots/src/components/editor/screenshot-editor.tsx`)
- Preview stage → Slide canvas: renders canvas (evidence: `app-store-screenshots/src/components/editor/preview-stage.tsx`)
- Slide canvas → Device frames: renders frames (evidence: `app-store-screenshots/src/components/editor/slide-canvas.tsx`)
- Project state → Project API: fetches project (evidence: `app-store-screenshots/src/lib/storage.ts`)
