# mckenz-e/vending_machine architecture

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

- Interactive diagram: https://gitdiagram.com/mckenz-e/vending_machine
- Repository: https://github.com/mckenz-e/vending_machine

## Overview

This is a small Flutter vending-machine app, but the README is only Flutter starter-project guidance and the supplied source excerpts contain no Dart code. The tree suggests home, transaction, and admin screens, plus item, stock, and presentation modules; their exact runtime wiring and user-to-result flow cannot be confirmed, so no interactions are asserted.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_screens["App screens"]
  node_home["Home page<br/>[home_page.dart]"]
  node_transaction["Transaction page"]
  node_admin["Admin page<br/>[admin_page.dart]"]
end

subgraph group_domain["Items and stock"]
  node_item["Item model<br/>[item.dart]"]
  node_items["Item list<br/>[item_list.dart]"]
  node_stock["Stock service<br/>[stock_service.dart]"]
end

subgraph group_presentation["Presentation"]
  node_image["Item image<br/>[item_image.dart]"]
  node_money["Money list<br/>[money_list.dart]"]
  node_theme["App theme<br/>[app_theme.dart]"]
end

node_user(("User"))
node_main["App entry<br/>[main.dart]"]

click node_main "https://github.com/mckenz-e/vending_machine/blob/main/lib/main.dart"
click node_home "https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/home_page.dart"
click node_transaction "https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/transaction_page.dart"
click node_admin "https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/admin_page.dart"
click node_item "https://github.com/mckenz-e/vending_machine/blob/main/lib/models/item.dart"
click node_items "https://github.com/mckenz-e/vending_machine/blob/main/lib/data/item_list.dart"
click node_stock "https://github.com/mckenz-e/vending_machine/blob/main/lib/services/stock_service.dart"
click node_image "https://github.com/mckenz-e/vending_machine/blob/main/lib/widgets/item_image.dart"
click node_money "https://github.com/mckenz-e/vending_machine/blob/main/lib/widgets/money_list.dart"
click node_theme "https://github.com/mckenz-e/vending_machine/blob/main/lib/app_theme.dart"

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_home,node_transaction,node_admin,node_user toneBlue
class node_item,node_items,node_stock toneAmber
class node_image,node_money,node_theme toneMint
class node_main toneTeal
```

## Components

### App screens

- [Home page](https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/home_page.dart): `lib/pages/home_page.dart`
- [Transaction page](https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/transaction_page.dart): `lib/pages/transaction_page.dart`
- [Admin page](https://github.com/mckenz-e/vending_machine/blob/main/lib/pages/admin_page.dart): `lib/pages/admin_page.dart`

### Items and stock

- [Item model](https://github.com/mckenz-e/vending_machine/blob/main/lib/models/item.dart): `lib/models/item.dart`
- [Item list](https://github.com/mckenz-e/vending_machine/blob/main/lib/data/item_list.dart): `lib/data/item_list.dart`
- [Stock service](https://github.com/mckenz-e/vending_machine/blob/main/lib/services/stock_service.dart): `lib/services/stock_service.dart`

### Presentation

- [Item image](https://github.com/mckenz-e/vending_machine/blob/main/lib/widgets/item_image.dart): `lib/widgets/item_image.dart`
- [Money list](https://github.com/mckenz-e/vending_machine/blob/main/lib/widgets/money_list.dart): `lib/widgets/money_list.dart`
- [App theme](https://github.com/mckenz-e/vending_machine/blob/main/lib/app_theme.dart): `lib/app_theme.dart`

### Other components

- **User**
- [App entry](https://github.com/mckenz-e/vending_machine/blob/main/lib/main.dart): `lib/main.dart`
