# rafaelafujii/loctaxa architecture

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

- Interactive diagram: https://gitdiagram.com/rafaelafujii/loctaxa
- Repository: https://github.com/rafaelafujii/loctaxa

## Overview

Loctaxa is a React interface for freelancers to find temporary hospitality shifts, inspect offers, manage an active shift, and view earnings and profile settings. The principal flow starts in the app shell, which filters mock opportunities and presents a map dashboard; users can select a gig and proceed to its offer or active-shift view. Authentication and registration screens are present, but the README and sampled code show no backend or persistent storage. Connections reflect the app’s shown state and imports; unsampled screen behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/rafaelafujii/loctaxa/blob/main/src/App.tsx) (App shell), [`src/components/ui/PrimaryButton.tsx`](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/PrimaryButton.tsx) (Primary button), [`src/components/map/MapPlaceholder.tsx`](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/map/MapPlaceholder.tsx) (Gig map), [`src/screens/ActiveGigScreen.tsx`](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/ActiveGigScreen.tsx) (Active shift)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App orchestration"]
  node_app_shell["App shell<br/>[App.tsx]"]
  node_gig_data["Mock gigs<br/>[mockGigs.ts]"]
  node_types["Domain types<br/>[index.ts]"]
end

subgraph group_discovery["Gig discovery"]
  node_map_dashboard["Map dashboard"]
  node_map_view["Gig map<br/>[MapPlaceholder.tsx]"]
  node_gig_marker["Gig marker<br/>[GigMarker.tsx]"]
  node_offer_sheet["Gig offer"]
end

subgraph group_work["Shift lifecycle"]
  node_active_gig["Active shift"]
  node_map_config["Maps config<br/>[maps.ts]"]
end

subgraph group_account["Access and account"]
  node_login["Login<br/>[LoginScreen.tsx]"]
  node_registration["Registration<br/>[CadastroScreen.tsx]"]
  node_profile["Profile<br/>[ProfileScreen.tsx]"]
  node_earnings["Earnings<br/>[EarningsScreen.tsx]"]
  node_settings["Settings<br/>[SettingsScreen.tsx]"]
end

subgraph group_shared["Shared UI"]
  node_bottom_nav["Bottom navigation"]
  node_code_modal["Code viewer"]
  node_primary_button["Primary button<br/>[PrimaryButton.tsx]"]
  node_text_input["Text input<br/>[TextInput.tsx]"]
  node_profession_toggle["Profession toggle"]
  node_social_button["Social button<br/>[SocialButton.tsx]"]
end

node_user(("Freelancer"))
node_google_maps["Google Maps"]

node_user -->|"uses"| node_app_shell
node_app_shell -->|"filters"| node_gig_data
node_app_shell -->|"renders"| node_map_dashboard
node_app_shell -->|"renders"| node_offer_sheet
node_app_shell -->|"renders"| node_active_gig
node_app_shell -->|"renders"| node_login
node_app_shell -->|"renders"| node_registration
node_app_shell -->|"renders"| node_profile
node_app_shell -->|"renders"| node_earnings
node_app_shell -->|"renders"| node_settings
node_app_shell -->|"renders"| node_bottom_nav
node_app_shell -->|"renders"| node_code_modal
node_map_dashboard -->|"renders"| node_map_view
node_map_view -->|"renders"| node_gig_marker
node_map_view -->|"reads key"| node_map_config
node_map_view -->|"renders map"| node_google_maps
node_active_gig -->|"reads key"| node_map_config
node_active_gig -->|"requests route"| node_google_maps
node_login -->|"uses"| node_text_input
node_login -->|"uses"| node_social_button
node_login -->|"uses"| node_primary_button
node_registration -->|"uses"| node_text_input
node_registration -->|"uses"| node_profession_toggle
node_registration -->|"uses"| node_primary_button
node_profile -->|"uses"| node_primary_button
node_offer_sheet -->|"uses"| node_primary_button
node_active_gig -->|"uses"| node_primary_button
node_settings -->|"uses"| node_primary_button

click node_app_shell "https://github.com/rafaelafujii/loctaxa/blob/main/src/App.tsx"
click node_gig_data "https://github.com/rafaelafujii/loctaxa/blob/main/src/data/mockGigs.ts"
click node_types "https://github.com/rafaelafujii/loctaxa/blob/main/src/types/index.ts"
click node_map_dashboard "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/MapDashboardScreen.tsx"
click node_map_view "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/map/MapPlaceholder.tsx"
click node_gig_marker "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/map/GigMarker.tsx"
click node_offer_sheet "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/GigOfferBottomSheet.tsx"
click node_active_gig "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/ActiveGigScreen.tsx"
click node_map_config "https://github.com/rafaelafujii/loctaxa/blob/main/src/constants/maps.ts"
click node_login "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/LoginScreen.tsx"
click node_registration "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/CadastroScreen.tsx"
click node_profile "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/ProfileScreen.tsx"
click node_earnings "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/EarningsScreen.tsx"
click node_settings "https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/SettingsScreen.tsx"
click node_bottom_nav "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/navigation/BottomNavigation.tsx"
click node_code_modal "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/CodeViewerModal.tsx"
click node_primary_button "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/PrimaryButton.tsx"
click node_text_input "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/TextInput.tsx"
click node_profession_toggle "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/ProfessionToggle.tsx"
click node_social_button "https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/SocialButton.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_app_shell,node_gig_data,node_types toneBlue
class node_map_dashboard,node_map_view,node_gig_marker,node_offer_sheet toneAmber
class node_active_gig,node_map_config toneMint
class node_login,node_registration,node_profile,node_earnings,node_settings toneRose
class node_bottom_nav,node_code_modal,node_primary_button,node_text_input,node_profession_toggle,node_social_button,node_user,node_google_maps toneIndigo
```

## Components

### App orchestration

- [App shell](https://github.com/rafaelafujii/loctaxa/blob/main/src/App.tsx): `src/App.tsx`
- [Mock gigs](https://github.com/rafaelafujii/loctaxa/blob/main/src/data/mockGigs.ts): `src/data/mockGigs.ts`
- [Domain types](https://github.com/rafaelafujii/loctaxa/blob/main/src/types/index.ts): `src/types/index.ts`

### Gig discovery

- [Map dashboard](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/MapDashboardScreen.tsx): `src/screens/MapDashboardScreen.tsx`
- [Gig map](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/map/MapPlaceholder.tsx): `src/components/map/MapPlaceholder.tsx`
- [Gig marker](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/map/GigMarker.tsx): `src/components/map/GigMarker.tsx`
- [Gig offer](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/GigOfferBottomSheet.tsx): `src/screens/GigOfferBottomSheet.tsx`

### Shift lifecycle

- [Active shift](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/ActiveGigScreen.tsx): `src/screens/ActiveGigScreen.tsx`
- [Maps config](https://github.com/rafaelafujii/loctaxa/blob/main/src/constants/maps.ts): `src/constants/maps.ts`

### Access and account

- [Login](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/LoginScreen.tsx): `src/screens/LoginScreen.tsx`
- [Registration](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/CadastroScreen.tsx): `src/screens/CadastroScreen.tsx`
- [Profile](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/ProfileScreen.tsx): `src/screens/ProfileScreen.tsx`
- [Earnings](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/EarningsScreen.tsx): `src/screens/EarningsScreen.tsx`
- [Settings](https://github.com/rafaelafujii/loctaxa/blob/main/src/screens/SettingsScreen.tsx): `src/screens/SettingsScreen.tsx`

### Shared UI

- [Bottom navigation](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/navigation/BottomNavigation.tsx): `src/components/navigation/BottomNavigation.tsx`
- [Code viewer](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/CodeViewerModal.tsx): `src/components/CodeViewerModal.tsx`
- [Primary button](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/PrimaryButton.tsx): `src/components/ui/PrimaryButton.tsx`
- [Text input](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/TextInput.tsx): `src/components/ui/TextInput.tsx`
- [Profession toggle](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/ProfessionToggle.tsx): `src/components/ui/ProfessionToggle.tsx`
- [Social button](https://github.com/rafaelafujii/loctaxa/blob/main/src/components/ui/SocialButton.tsx): `src/components/ui/SocialButton.tsx`

### Other components

- **Freelancer**
- **Google Maps**

## Connections

- Freelancer → App shell: uses
- App shell → Mock gigs: filters (evidence: `src/App.tsx`)
- App shell → Map dashboard: renders (evidence: `src/App.tsx`)
- App shell → Gig offer: renders (evidence: `src/App.tsx`)
- App shell → Active shift: renders (evidence: `src/App.tsx`)
- App shell → Login: renders (evidence: `src/App.tsx`)
- App shell → Registration: renders (evidence: `src/App.tsx`)
- App shell → Profile: renders (evidence: `src/App.tsx`)
- App shell → Earnings: renders (evidence: `src/App.tsx`)
- App shell → Settings: renders (evidence: `src/App.tsx`)
- App shell → Bottom navigation: renders (evidence: `src/App.tsx`)
- App shell → Code viewer: renders (evidence: `src/App.tsx`)
- Map dashboard → Gig map: renders (evidence: `src/screens/MapDashboardScreen.tsx`)
- Gig map → Gig marker: renders (evidence: `src/components/map/MapPlaceholder.tsx`)
- Gig map → Maps config: reads key (evidence: `src/components/map/MapPlaceholder.tsx`)
- Gig map → Google Maps: renders map (evidence: `src/components/map/MapPlaceholder.tsx`)
- Active shift → Maps config: reads key (evidence: `src/screens/ActiveGigScreen.tsx`)
- Active shift → Google Maps: requests route (evidence: `src/screens/ActiveGigScreen.tsx`)
- Login → Text input: uses (evidence: `src/screens/LoginScreen.tsx`)
- Login → Social button: uses (evidence: `src/screens/LoginScreen.tsx`)
- Login → Primary button: uses (evidence: `src/screens/LoginScreen.tsx`)
- Registration → Text input: uses (evidence: `src/screens/CadastroScreen.tsx`)
- Registration → Profession toggle: uses (evidence: `src/screens/CadastroScreen.tsx`)
- Registration → Primary button: uses (evidence: `src/screens/CadastroScreen.tsx`)
- Profile → Primary button: uses (evidence: `src/screens/ProfileScreen.tsx`)
- Gig offer → Primary button: uses (evidence: `src/screens/GigOfferBottomSheet.tsx`)
- Active shift → Primary button: uses (evidence: `src/screens/ActiveGigScreen.tsx`)
- Settings → Primary button: uses (evidence: `src/screens/SettingsScreen.tsx`)
