# whooslizi/lucycurry architecture

> Architecture diagram of the GitHub repository whooslizi/lucycurry, 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/whooslizi/lucycurry
- Repository: https://github.com/whooslizi/lucycurry

## Overview

Tiệm Càri của cô Lộc Lucy is a browser-based curry-shop management game. The player accepts the disclaimer, starts a game, enters the story and tutorial, then runs shop days handling orders, cooking, packing, delivery, and pricing. Daily summaries advance the week, with a possible robbery cutscene and an ending after day seven. Shared reducer state persists in local storage. The README is empty; edges reflect shown renders, calls, and source-index references, so unsampled behavior is not expanded into guessed connections.

Main entry points: [`src/components/ShopScene.tsx`](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/ShopScene.tsx) (Shop scene), [`src/components/GameScreen.tsx`](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/GameScreen.tsx) (Game coordinator), [`src/game/gameState.tsx`](https://github.com/whooslizi/lucycurry/blob/eoleun/src/game/gameState.tsx) (Reducer and save), [`src/App.tsx`](https://github.com/whooslizi/lucycurry/blob/eoleun/src/App.tsx) (App flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and onboarding"]
  node_app["App flow<br/>[App.tsx]"]
  node_disclaimer["Disclaimer"]
  node_start["Start screen<br/>[StartScreen.tsx]"]
  node_story["Story<br/>[StoryScreen.tsx]"]
  node_tutorial["Tutorial<br/>[TutorialScreen.tsx]"]
end

subgraph group_gameplay["Shop gameplay"]
  node_shop["Shop scene<br/>[ShopScene.tsx]"]
  node_pricing["Pricing menu<br/>[PricingMenu.tsx]"]
  node_outside["Outside view<br/>[OutsideView.tsx]"]
  node_live["CariLive chat<br/>[CariLive.tsx]"]
  node_recipe["Recipe modal<br/>[RecipeModal.tsx]"]
  node_delivery["Delivery minigame"]
end

subgraph group_progression["Day and story progression"]
  node_game["Game coordinator<br/>[GameScreen.tsx]"]
  node_summary["Daily summary<br/>[DailySummary.tsx]"]
  node_night["Robbery cutscene<br/>[NightCutscene.tsx]"]
  node_ending["Game ending<br/>[EndingScreen.tsx]"]
end

subgraph group_state["Game state and data"]
  node_state["Reducer and save<br/>[gameState.tsx]"]
  node_types["Game types<br/>[game.ts]"]
end

node_player(("Player"))

node_player -->|"starts"| node_app
node_app -->|"renders"| node_disclaimer
node_app -->|"renders"| node_start
node_app -->|"renders"| node_game
node_player -->|"accepts"| node_disclaimer
node_player -->|"chooses"| node_start
node_game -->|"renders"| node_story
node_game -->|"renders"| node_tutorial
node_game -->|"renders"| node_shop
node_game -->|"renders"| node_summary
node_game -->|"renders"| node_night
node_game -->|"renders"| node_ending
node_shop -->|"renders"| node_pricing
node_shop -->|"renders"| node_outside
node_shop -->|"renders"| node_live
node_shop -->|"renders"| node_recipe
node_shop -->|"renders"| node_tutorial
node_shop -->|"renders"| node_delivery
node_game -->|"provides state"| node_state
node_shop -->|"reads and dispatches"| node_state
node_summary -->|"dispatches updates"| node_state
node_night -->|"dispatches expense"| node_state
node_live -->|"reads pricing"| node_state
node_state -->|"uses definitions"| node_types
node_shop -->|"uses order types"| node_types

click node_app "https://github.com/whooslizi/lucycurry/blob/eoleun/src/App.tsx"
click node_disclaimer "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DisclaimerScreen.tsx"
click node_start "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/StartScreen.tsx"
click node_game "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/GameScreen.tsx"
click node_story "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/StoryScreen.tsx"
click node_tutorial "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/TutorialScreen.tsx"
click node_shop "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/ShopScene.tsx"
click node_pricing "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/PricingMenu.tsx"
click node_outside "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/OutsideView.tsx"
click node_live "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/CariLive.tsx"
click node_recipe "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/RecipeModal.tsx"
click node_delivery "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DeliveryMinigame.tsx"
click node_summary "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DailySummary.tsx"
click node_night "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/NightCutscene.tsx"
click node_ending "https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/EndingScreen.tsx"
click node_state "https://github.com/whooslizi/lucycurry/blob/eoleun/src/game/gameState.tsx"
click node_types "https://github.com/whooslizi/lucycurry/blob/eoleun/src/types/game.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_app,node_disclaimer,node_start,node_story,node_tutorial toneBlue
class node_shop,node_pricing,node_outside,node_live,node_recipe,node_delivery toneAmber
class node_game,node_summary,node_night,node_ending toneMint
class node_state,node_types toneRose
class node_player toneIndigo
```

## Components

### Entry and onboarding

- [App flow](https://github.com/whooslizi/lucycurry/blob/eoleun/src/App.tsx): `src/App.tsx`
- [Disclaimer](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DisclaimerScreen.tsx): `src/components/DisclaimerScreen.tsx`
- [Start screen](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/StartScreen.tsx): `src/components/StartScreen.tsx`
- [Story](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/StoryScreen.tsx): `src/components/StoryScreen.tsx`
- [Tutorial](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/TutorialScreen.tsx): `src/components/TutorialScreen.tsx`

### Shop gameplay

- [Shop scene](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/ShopScene.tsx): `src/components/ShopScene.tsx`
- [Pricing menu](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/PricingMenu.tsx): `src/components/PricingMenu.tsx`
- [Outside view](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/OutsideView.tsx): `src/components/OutsideView.tsx`
- [CariLive chat](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/CariLive.tsx): `src/components/CariLive.tsx`
- [Recipe modal](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/RecipeModal.tsx): `src/components/RecipeModal.tsx`
- [Delivery minigame](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DeliveryMinigame.tsx): `src/components/DeliveryMinigame.tsx`

### Day and story progression

- [Game coordinator](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/GameScreen.tsx): `src/components/GameScreen.tsx`
- [Daily summary](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/DailySummary.tsx): `src/components/DailySummary.tsx`
- [Robbery cutscene](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/NightCutscene.tsx): `src/components/NightCutscene.tsx`
- [Game ending](https://github.com/whooslizi/lucycurry/blob/eoleun/src/components/EndingScreen.tsx): `src/components/EndingScreen.tsx`

### Game state and data

- [Reducer and save](https://github.com/whooslizi/lucycurry/blob/eoleun/src/game/gameState.tsx): `src/game/gameState.tsx`
- [Game types](https://github.com/whooslizi/lucycurry/blob/eoleun/src/types/game.ts): `src/types/game.ts`

### Other components

- **Player**

## Connections

- Player → App flow: starts (evidence: `src/App.tsx`)
- App flow → Disclaimer: renders (evidence: `src/App.tsx`)
- App flow → Start screen: renders (evidence: `src/App.tsx`)
- App flow → Game coordinator: renders (evidence: `src/App.tsx`)
- Player → Disclaimer: accepts (evidence: `src/components/DisclaimerScreen.tsx`)
- Player → Start screen: chooses
- Game coordinator → Story: renders (evidence: `src/components/GameScreen.tsx`)
- Game coordinator → Tutorial: renders (evidence: `src/components/GameScreen.tsx`)
- Game coordinator → Shop scene: renders (evidence: `src/components/GameScreen.tsx`)
- Game coordinator → Daily summary: renders (evidence: `src/components/GameScreen.tsx`)
- Game coordinator → Robbery cutscene: renders (evidence: `src/components/GameScreen.tsx`)
- Game coordinator → Game ending: renders (evidence: `src/components/GameScreen.tsx`)
- Shop scene → Pricing menu: renders (evidence: `src/components/ShopScene.tsx`)
- Shop scene → Outside view: renders (evidence: `src/components/ShopScene.tsx`)
- Shop scene → CariLive chat: renders (evidence: `src/components/ShopScene.tsx`)
- Shop scene → Recipe modal: renders (evidence: `src/components/ShopScene.tsx`)
- Shop scene → Tutorial: renders (evidence: `src/components/ShopScene.tsx`)
- Shop scene → Delivery minigame: renders (evidence: `src/components/ShopScene.tsx`)
- Game coordinator → Reducer and save: provides state (evidence: `src/components/GameScreen.tsx`)
- Shop scene → Reducer and save: reads and dispatches (evidence: `src/components/ShopScene.tsx`)
- Daily summary → Reducer and save: dispatches updates (evidence: `src/components/DailySummary.tsx`)
- Robbery cutscene → Reducer and save: dispatches expense (evidence: `src/components/NightCutscene.tsx`)
- CariLive chat → Reducer and save: reads pricing (evidence: `src/components/CariLive.tsx`)
- Reducer and save → Game types: uses definitions (evidence: `src/game/gameState.tsx`)
- Shop scene → Game types: uses order types (evidence: `src/components/ShopScene.tsx`)
