# rainulrafi/shoplite architecture

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

- Interactive diagram: https://gitdiagram.com/rainulrafi/shoplite
- Repository: https://github.com/rainulrafi/shoplite

## Overview

Shoplite is a Flutter shopping app. Its tree indicates a customer workflow spanning product discovery and detail, sign-in, wishlist, and account tasks such as managing addresses, profile, and settings. The feature directories also show API-backed auth and product data, plus local SQLite repositories for several account-related domains. The Flutter implementation was not excerpted and the README is only a starter template, so the dashed links below represent likely wiring inferred from names and structure, not verified calls.

Main entry points: [`lib/features/shell/app_shell.dart`](https://github.com/rainulrafi/shoplite/blob/main/lib/features/shell/app_shell.dart) (App shell), [`lib/features/products/presentation/product_list_screen.dart`](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_list_screen.dart) (Product listings), [`lib/features/products/data/api_product_repository.dart`](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/data/api_product_repository.dart) (Product API), [`lib/core/database/app_database.dart`](https://github.com/rainulrafi/shoplite/blob/main/lib/core/database/app_database.dart) (Local database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_entry["Flutter entry<br/>[main.dart]"]
  node_shell["App shell<br/>[app_shell.dart]"]
end

subgraph group_shopping["Shopping"]
  node_catalog["Product listings"]
  node_catalog_state["Listing state"]
  node_detail["Product detail"]
  node_detail_state["Detail state"]
  node_product_api["Product API"]
  node_product_data["Product data<br/>[product.dart]"]
  node_wishlist["Wishlist"]
  node_wishlist_state["Wishlist state"]
  node_wishlist_store["Wishlist storage"]
end

subgraph group_identity["Identity"]
  node_login["Login<br/>[login_screen.dart]"]
  node_auth_state["Auth state<br/>[auth_provider.dart]"]
  node_auth_api["Auth API"]
end

subgraph group_account["Account"]
  node_addresses["Addresses"]
  node_address_store["Address storage"]
  node_profile["Profile editing"]
  node_profile_store["Profile storage"]
  node_settings["Settings"]
  node_settings_store["Settings storage"]
end

subgraph group_platform["Shared services"]
  node_network["API client<br/>[api_client.dart]"]
  node_token_store["Token storage"]
  node_database[("Local database<br/>[app_database.dart]")]
end

node_customer(("Customer"))

node_customer -.->|"opens app"| node_entry
node_entry -.->|"starts"| node_shell
node_shell -.->|"shows"| node_catalog
node_customer -.->|"browses"| node_catalog
node_catalog -.->|"uses state"| node_catalog_state
node_catalog_state -.->|"loads products"| node_product_api
node_product_api -.->|"uses client"| node_network
node_catalog -.->|"opens item"| node_detail
node_detail -.->|"uses state"| node_detail_state
node_detail_state -.->|"loads product"| node_product_api
node_product_api -.->|"provides data"| node_product_data
node_shell -.->|"shows"| node_wishlist
node_wishlist -.->|"uses state"| node_wishlist_state
node_wishlist_state -.->|"persists items"| node_wishlist_store
node_customer -.->|"signs in"| node_login
node_login -.->|"uses state"| node_auth_state
node_auth_state -.->|"authenticates"| node_auth_api
node_auth_api -.->|"uses client"| node_network
node_auth_state -.->|"stores tokens"| node_token_store
node_shell -.->|"shows"| node_addresses
node_addresses -.->|"persists addresses"| node_address_store
node_shell -.->|"shows"| node_profile
node_profile -.->|"persists profile"| node_profile_store
node_shell -.->|"shows"| node_settings
node_settings -.->|"persists settings"| node_settings_store
node_wishlist_store -.->|"uses database"| node_database
node_address_store -.->|"uses database"| node_database
node_profile_store -.->|"uses database"| node_database
node_settings_store -.->|"uses database"| node_database

click node_entry "https://github.com/rainulrafi/shoplite/blob/main/lib/main.dart"
click node_shell "https://github.com/rainulrafi/shoplite/blob/main/lib/features/shell/app_shell.dart"
click node_catalog "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_list_screen.dart"
click node_catalog_state "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_list_provider.dart"
click node_detail "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_detail_screen.dart"
click node_detail_state "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_detail_provider.dart"
click node_product_api "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/data/api_product_repository.dart"
click node_product_data "https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/data/product.dart"
click node_wishlist "https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/presentation/wishlist_screen.dart"
click node_wishlist_state "https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/presentation/wishlist_provider.dart"
click node_wishlist_store "https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/data/sqlite_wishlist_repository.dart"
click node_login "https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/presentation/login_screen.dart"
click node_auth_state "https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/presentation/auth_provider.dart"
click node_auth_api "https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/data/api_auth_repository.dart"
click node_addresses "https://github.com/rainulrafi/shoplite/blob/main/lib/features/addresses/presentation/addresses_screen.dart"
click node_address_store "https://github.com/rainulrafi/shoplite/blob/main/lib/features/addresses/data/sqlite_address_repository.dart"
click node_profile "https://github.com/rainulrafi/shoplite/blob/main/lib/features/profile/presentation/edit_profile_screen.dart"
click node_profile_store "https://github.com/rainulrafi/shoplite/blob/main/lib/features/profile/data/sqlite_profile_repository.dart"
click node_settings "https://github.com/rainulrafi/shoplite/blob/main/lib/features/settings/presentation/settings_provider.dart"
click node_settings_store "https://github.com/rainulrafi/shoplite/blob/main/lib/features/settings/data/sqlite_settings_repository.dart"
click node_network "https://github.com/rainulrafi/shoplite/blob/main/lib/core/network/api_client.dart"
click node_token_store "https://github.com/rainulrafi/shoplite/blob/main/lib/core/storage/secure_token_store.dart"
click node_database "https://github.com/rainulrafi/shoplite/blob/main/lib/core/database/app_database.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_entry,node_shell toneBlue
class node_catalog,node_catalog_state,node_detail,node_detail_state,node_product_api,node_product_data,node_wishlist,node_wishlist_state,node_wishlist_store toneAmber
class node_login,node_auth_state,node_auth_api toneMint
class node_addresses,node_address_store,node_profile,node_profile_store,node_settings,node_settings_store toneRose
class node_network,node_token_store,node_database,node_customer toneIndigo
```

## Components

### App shell

- [Flutter entry](https://github.com/rainulrafi/shoplite/blob/main/lib/main.dart): `lib/main.dart`
- [App shell](https://github.com/rainulrafi/shoplite/blob/main/lib/features/shell/app_shell.dart): `lib/features/shell/app_shell.dart`

### Shopping

- [Product listings](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_list_screen.dart): `lib/features/products/presentation/product_list_screen.dart`
- [Listing state](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_list_provider.dart): `lib/features/products/presentation/product_list_provider.dart`
- [Product detail](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_detail_screen.dart): `lib/features/products/presentation/product_detail_screen.dart`
- [Detail state](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/presentation/product_detail_provider.dart): `lib/features/products/presentation/product_detail_provider.dart`
- [Product API](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/data/api_product_repository.dart): `lib/features/products/data/api_product_repository.dart`
- [Product data](https://github.com/rainulrafi/shoplite/blob/main/lib/features/products/data/product.dart): `lib/features/products/data/product.dart`
- [Wishlist](https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/presentation/wishlist_screen.dart): `lib/features/wishlist/presentation/wishlist_screen.dart`
- [Wishlist state](https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/presentation/wishlist_provider.dart): `lib/features/wishlist/presentation/wishlist_provider.dart`
- [Wishlist storage](https://github.com/rainulrafi/shoplite/blob/main/lib/features/wishlist/data/sqlite_wishlist_repository.dart): `lib/features/wishlist/data/sqlite_wishlist_repository.dart`

### Identity

- [Login](https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/presentation/login_screen.dart): `lib/features/auth/presentation/login_screen.dart`
- [Auth state](https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/presentation/auth_provider.dart): `lib/features/auth/presentation/auth_provider.dart`
- [Auth API](https://github.com/rainulrafi/shoplite/blob/main/lib/features/auth/data/api_auth_repository.dart): `lib/features/auth/data/api_auth_repository.dart`

### Account

- [Addresses](https://github.com/rainulrafi/shoplite/blob/main/lib/features/addresses/presentation/addresses_screen.dart): `lib/features/addresses/presentation/addresses_screen.dart`
- [Address storage](https://github.com/rainulrafi/shoplite/blob/main/lib/features/addresses/data/sqlite_address_repository.dart): `lib/features/addresses/data/sqlite_address_repository.dart`
- [Profile editing](https://github.com/rainulrafi/shoplite/blob/main/lib/features/profile/presentation/edit_profile_screen.dart): `lib/features/profile/presentation/edit_profile_screen.dart`
- [Profile storage](https://github.com/rainulrafi/shoplite/blob/main/lib/features/profile/data/sqlite_profile_repository.dart): `lib/features/profile/data/sqlite_profile_repository.dart`
- [Settings](https://github.com/rainulrafi/shoplite/blob/main/lib/features/settings/presentation/settings_provider.dart): `lib/features/settings/presentation/settings_provider.dart`
- [Settings storage](https://github.com/rainulrafi/shoplite/blob/main/lib/features/settings/data/sqlite_settings_repository.dart): `lib/features/settings/data/sqlite_settings_repository.dart`

### Shared services

- [API client](https://github.com/rainulrafi/shoplite/blob/main/lib/core/network/api_client.dart): `lib/core/network/api_client.dart`
- [Token storage](https://github.com/rainulrafi/shoplite/blob/main/lib/core/storage/secure_token_store.dart): `lib/core/storage/secure_token_store.dart`
- [Local database](https://github.com/rainulrafi/shoplite/blob/main/lib/core/database/app_database.dart): `lib/core/database/app_database.dart`

### Other components

- **Customer**

## Connections

- Customer → Flutter entry: opens app
- Flutter entry → App shell: starts
- App shell → Product listings: shows
- Customer → Product listings: browses
- Product listings → Listing state: uses state
- Listing state → Product API: loads products
- Product API → API client: uses client
- Product listings → Product detail: opens item
- Product detail → Detail state: uses state
- Detail state → Product API: loads product
- Product API → Product data: provides data
- App shell → Wishlist: shows
- Wishlist → Wishlist state: uses state
- Wishlist state → Wishlist storage: persists items
- Customer → Login: signs in
- Login → Auth state: uses state
- Auth state → Auth API: authenticates
- Auth API → API client: uses client
- Auth state → Token storage: stores tokens
- App shell → Addresses: shows
- Addresses → Address storage: persists addresses
- App shell → Profile editing: shows
- Profile editing → Profile storage: persists profile
- App shell → Settings: shows
- Settings → Settings storage: persists settings
- Wishlist storage → Local database: uses database
- Address storage → Local database: uses database
- Profile storage → Local database: uses database
- Settings storage → Local database: uses database
