# chonwai/nfc_linkcard_event_admin_app_expo architecture

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

- Interactive diagram: https://gitdiagram.com/chonwai/nfc_linkcard_event_admin_app_expo
- Repository: https://github.com/chonwai/nfc_linkcard_event_admin_app_expo

## Overview

This is a mobile event-administration app for staff managing events and attendee check-in. The principal workflow is: sign in, select a managed event, find a registration, then check the attendee in; related event tools cover roster/detail views, badges, NFC binding and reading, walk-ins, and token information. The graph separates routed screens, service/API access, and session/event state. Several feature screens are represented from the file tree and UI copy; their internal calls were not sampled, so uncertain links are omitted.

Main entry points: [`src/services/api.ts`](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/api.ts) (API client), [`src/components/ui`](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/tree/main/src/components/ui) (Shared UI components), [`src/app/index.tsx`](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/index.tsx) (Sign in), [`src/services/event.service.ts`](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/event.service.ts) (Event service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_session["Session and navigation"]
  node_login["Sign in<br/>[index.tsx]"]
  node_settings["Settings<br/>[settings.tsx]"]
end

subgraph group_events["Event operations"]
  node_event_home["Managed events<br/>[home.tsx]"]
  node_event_overview["Event overview<br/>[overview.tsx]"]
  node_token["Event token<br/>[token.tsx]"]
end

subgraph group_attendees["Attendee workflows"]
  node_roster["Registration roster<br/>[registrations.tsx]"]
  node_registrant["Registration detail"]
  node_checkin["Check-in<br/>[check-in.tsx]"]
  node_walkin["Walk-in registration<br/>[walk-in.tsx]"]
  node_badges["Badge management<br/>[badges.tsx]"]
  node_nfc_bind["NFC binding<br/>[nfc-bind.tsx]"]
  node_nfc_read["NFC reader<br/>[nfc-read.tsx]"]
end

subgraph group_platform["Services and state"]
  node_auth_state["Authentication state<br/>[auth.store.ts]"]
  node_event_state["Event state<br/>[event.store.ts]"]
  node_auth_service["Authentication service<br/>[auth.service.ts]"]
  node_event_service["Event service<br/>[event.service.ts]"]
  node_registration_service["Registration service"]
  node_nfc_service["NFC service<br/>[nfc.service.ts]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_ui["Shared interface"]
  node_ui_components["Shared UI components"]
  node_theme["Theme tokens<br/>[theme.ts]"]
end

node_operator(("Event operator"))
node_backend{{"LinkCard backend"}}

node_operator -->|"signs in"| node_login
node_login -->|"submits credentials"| node_auth_service
node_login -->|"sets session"| node_auth_state
node_auth_state -->|"restores identity"| node_auth_service
node_event_home -->|"loads events"| node_event_state
node_event_state -->|"fetches events"| node_event_service
node_roster -->|"loads roster"| node_event_service
node_checkin -->|"loads event data"| node_event_service
node_checkin -->|"checks in attendee"| node_registration_service
node_registrant -->|"loads registration data"| node_registration_service
node_auth_service -->|"sends requests"| node_api_client
node_event_service -->|"sends requests"| node_api_client
node_registration_service -->|"sends requests"| node_api_client
node_nfc_service -->|"sends requests"| node_api_client
node_api_client -.->|"makes HTTP requests"| node_backend
node_login -->|"renders"| node_ui_components
node_checkin -->|"renders"| node_ui_components
node_roster -->|"renders"| node_ui_components
node_registrant -->|"renders"| node_ui_components
node_ui_components -->|"uses tokens"| node_theme

click node_login "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/index.tsx"
click node_auth_state "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/stores/auth.store.ts"
click node_event_home "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/home.tsx"
click node_event_overview "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/overview.tsx"
click node_roster "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/registrations.tsx"
click node_registrant "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/registrant/%5BregistrationId%5D.tsx"
click node_checkin "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/check-in.tsx"
click node_walkin "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/walk-in.tsx"
click node_badges "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/badges.tsx"
click node_nfc_bind "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/nfc-bind.tsx"
click node_nfc_read "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/nfc-read.tsx"
click node_token "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/token.tsx"
click node_settings "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/settings.tsx"
click node_event_state "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/stores/event.store.ts"
click node_auth_service "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/auth.service.ts"
click node_event_service "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/event.service.ts"
click node_registration_service "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/registration.service.ts"
click node_nfc_service "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/nfc.service.ts"
click node_api_client "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/api.ts"
click node_ui_components "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/tree/main/src/components/ui"
click node_theme "https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/constants/theme.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_login,node_settings toneBlue
class node_event_home,node_event_overview,node_token toneAmber
class node_roster,node_registrant,node_checkin,node_walkin,node_badges,node_nfc_bind,node_nfc_read toneMint
class node_auth_state,node_event_state,node_auth_service,node_event_service,node_registration_service,node_nfc_service,node_api_client toneRose
class node_ui_components,node_theme,node_operator,node_backend toneIndigo
```

## Components

### Session and navigation

- [Sign in](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/index.tsx): `src/app/index.tsx`
- [Settings](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/settings.tsx): `src/app/(auth)/settings.tsx`

### Event operations

- [Managed events](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/home.tsx): `src/app/(auth)/home.tsx`
- [Event overview](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/overview.tsx): `src/app/(auth)/[eventId]/overview.tsx`
- [Event token](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/token.tsx): `src/app/(auth)/[eventId]/token.tsx`

### Attendee workflows

- [Registration roster](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/registrations.tsx): `src/app/(auth)/[eventId]/registrations.tsx`
- [Registration detail](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/registrant/%5BregistrationId%5D.tsx): `src/app/(auth)/[eventId]/registrant/[registrationId].tsx`
- [Check-in](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/check-in.tsx): `src/app/(auth)/[eventId]/check-in.tsx`
- [Walk-in registration](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/walk-in.tsx): `src/app/(auth)/[eventId]/walk-in.tsx`
- [Badge management](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/badges.tsx): `src/app/(auth)/[eventId]/badges.tsx`
- [NFC binding](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/nfc-bind.tsx): `src/app/(auth)/[eventId]/nfc-bind.tsx`
- [NFC reader](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/app/(auth)/%5BeventId%5D/nfc-read.tsx): `src/app/(auth)/[eventId]/nfc-read.tsx`

### Services and state

- [Authentication state](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/stores/auth.store.ts): `src/stores/auth.store.ts`
- [Event state](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/stores/event.store.ts): `src/stores/event.store.ts`
- [Authentication service](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/auth.service.ts): `src/services/auth.service.ts`
- [Event service](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/event.service.ts): `src/services/event.service.ts`
- [Registration service](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/registration.service.ts): `src/services/registration.service.ts`
- [NFC service](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/nfc.service.ts): `src/services/nfc.service.ts`
- [API client](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/services/api.ts): `src/services/api.ts`

### Shared interface

- [Shared UI components](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/tree/main/src/components/ui): `src/components/ui`
- [Theme tokens](https://github.com/chonwai/nfc_linkcard_event_admin_app_expo/blob/main/src/constants/theme.ts): `src/constants/theme.ts`

### Other components

- **Event operator**
- **LinkCard backend**

## Connections

- Event operator → Sign in: signs in (evidence: `src/app/index.tsx`)
- Sign in → Authentication service: submits credentials (evidence: `src/app/index.tsx`)
- Sign in → Authentication state: sets session (evidence: `src/app/index.tsx`)
- Authentication state → Authentication service: restores identity (evidence: `src/stores/auth.store.ts`)
- Managed events → Event state: loads events (evidence: `src/app/(auth)/home.tsx`)
- Event state → Event service: fetches events (evidence: `src/stores/event.store.ts`)
- Registration roster → Event service: loads roster (evidence: `src/app/(auth)/[eventId]/registrations.tsx`)
- Check-in → Event service: loads event data (evidence: `src/app/(auth)/[eventId]/check-in.tsx`)
- Check-in → Registration service: checks in attendee (evidence: `src/app/(auth)/[eventId]/check-in.tsx`)
- Registration detail → Registration service: loads registration data (evidence: `src/app/(auth)/[eventId]/registrant/[registrationId].tsx`)
- Authentication service → API client: sends requests (evidence: `src/services/auth.service.ts`)
- Event service → API client: sends requests (evidence: `src/services/event.service.ts`)
- Registration service → API client: sends requests (evidence: `src/services/registration.service.ts`)
- NFC service → API client: sends requests (evidence: `src/services/nfc.service.ts`)
- API client → LinkCard backend: makes HTTP requests
- Sign in → Shared UI components: renders (evidence: `src/app/index.tsx`)
- Check-in → Shared UI components: renders (evidence: `src/app/(auth)/[eventId]/check-in.tsx`)
- Registration roster → Shared UI components: renders (evidence: `src/app/(auth)/[eventId]/registrations.tsx`)
- Registration detail → Shared UI components: renders (evidence: `src/app/(auth)/[eventId]/registrant/[registrationId].tsx`)
- Shared UI components → Theme tokens: uses tokens (evidence: `src/components/ui/useFocusRing.ts`)
