# nasstyfox/pastimes-android architecture

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

- Interactive diagram: https://gitdiagram.com/nasstyfox/pastimes-android
- Repository: https://github.com/nasstyfox/pastimes-android

## Overview

Pastimes is an Android clothing-commerce app with buyer, seller, and admin surfaces, plus login and registration. The likely user journey is authentication, entry to a role-specific dashboard, then product or cart activity for buyers and management activity for sellers or admins. The tree also shows API, repository, model, and token-storage layers. No runtime source excerpts or README were provided, so the relationships below are unverified architectural links rather than confirmed calls.

Main entry points: [`app/src/main/java/com/example/pastimes/clothing/network`](https://github.com/nasstyfox/pastimes-android/tree/master/app/src/main/java/com/example/pastimes/clothing/network) (API services), [`app/src/main/java/com/example/pastimes/clothing/repository/ProductRepository.kt`](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/ProductRepository.kt) (Product repository), [`app/src/main/java/com/example/pastimes/clothing/ui/main/MainActivity.kt`](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/main/MainActivity.kt) (Main navigation), [`app/src/main/java/com/example/pastimes/clothing/repository/AuthRepository.kt`](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/AuthRepository.kt) (Auth repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_login["Login<br/>[LoginActivity.kt]"]
  node_register["Registration"]
  node_authvm["Auth state<br/>[LoginViewModel.kt]"]
  node_authrepo["Auth repository<br/>[AuthRepository.kt]"]
  node_token["Token storage<br/>[TokenManager.kt]"]
end

subgraph group_experience["Role Experiences"]
  node_main["Main navigation<br/>[MainActivity.kt]"]
  node_buyer["Buyer dashboard"]
  node_buyervm["Buyer state"]
  node_seller["Seller dashboard"]
  node_sellervm["Seller state"]
  node_admin["Admin dashboard"]
  node_adminvm["Admin state"]
  node_adapters["List adapters"]
end

subgraph group_commerce["Commerce Data"]
  node_products["Product repository"]
  node_cart["Cart repository<br/>[CartRepository.kt]"]
  node_models["Clothing models<br/>[ClothingModels.kt]"]
  node_adminrepo["Admin repository<br/>[AdminRepository.kt]"]
end

subgraph group_platform["API Platform"]
  node_apis["API services"]
  node_retrofit["Retrofit client<br/>[RetrofitClient.kt]"]
end

node_user(("App user"))
node_backend["Commerce backend"]

node_user -.->|"signs in"| node_login
node_user -.->|"registers"| node_register
node_login -.->|"submits credentials"| node_authvm
node_register -.->|"creates account"| node_authvm
node_authvm -.->|"requests auth"| node_authrepo
node_authrepo -.->|"uses API"| node_apis
node_authrepo -.->|"stores token"| node_token
node_main -.->|"shows role view"| node_buyer
node_main -.->|"shows role view"| node_seller
node_main -.->|"shows role view"| node_admin
node_buyer -.->|"uses state"| node_buyervm
node_seller -.->|"uses state"| node_sellervm
node_admin -.->|"uses state"| node_adminvm
node_buyervm -.->|"loads products"| node_products
node_buyervm -.->|"manages cart"| node_cart
node_sellervm -.->|"manages products"| node_products
node_adminvm -.->|"manages users"| node_adminrepo
node_buyer -.->|"renders lists"| node_adapters
node_admin -.->|"renders users"| node_adapters
node_products -.->|"uses API"| node_apis
node_cart -.->|"uses API"| node_apis
node_adminrepo -.->|"uses API"| node_apis
node_apis -.->|"uses client"| node_retrofit
node_retrofit -.->|"sends requests"| node_backend
node_products -.->|"uses models"| node_models

click node_login "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginActivity.kt"
click node_register "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/RegisterActivity.kt"
click node_authvm "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginViewModel.kt"
click node_authrepo "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/AuthRepository.kt"
click node_token "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/data/TokenManager.kt"
click node_main "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/main/MainActivity.kt"
click node_buyer "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardFragment.kt"
click node_buyervm "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardViewModel.kt"
click node_seller "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardFragment.kt"
click node_sellervm "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardViewModel.kt"
click node_admin "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardFragment.kt"
click node_adminvm "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardViewModel.kt"
click node_adapters "https://github.com/nasstyfox/pastimes-android/tree/master/app/src/main/java/com/example/pastimes/clothing/adapter"
click node_products "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/ProductRepository.kt"
click node_cart "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/CartRepository.kt"
click node_models "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/data/ClothingModels.kt"
click node_adminrepo "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/AdminRepository.kt"
click node_apis "https://github.com/nasstyfox/pastimes-android/tree/master/app/src/main/java/com/example/pastimes/clothing/network"
click node_retrofit "https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/network/RetrofitClient.kt"

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_register,node_authvm,node_authrepo,node_token,node_user toneBlue
class node_main,node_buyer,node_buyervm,node_seller,node_sellervm,node_admin,node_adminvm,node_adapters toneAmber
class node_products,node_cart,node_models,node_adminrepo toneMint
class node_apis,node_retrofit toneRose
class node_backend toneIndigo
```

## Components

### Authentication

- [Login](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginActivity.kt): `app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginActivity.kt`
- [Registration](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/RegisterActivity.kt): `app/src/main/java/com/example/pastimes/clothing/ui/auth/RegisterActivity.kt`
- [Auth state](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginViewModel.kt): `app/src/main/java/com/example/pastimes/clothing/ui/auth/LoginViewModel.kt`
- [Auth repository](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/AuthRepository.kt): `app/src/main/java/com/example/pastimes/clothing/repository/AuthRepository.kt`
- [Token storage](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/data/TokenManager.kt): `app/src/main/java/com/example/pastimes/clothing/data/TokenManager.kt`

### Role Experiences

- [Main navigation](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/main/MainActivity.kt): `app/src/main/java/com/example/pastimes/clothing/ui/main/MainActivity.kt`
- [Buyer dashboard](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardFragment.kt): `app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardFragment.kt`
- [Buyer state](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardViewModel.kt): `app/src/main/java/com/example/pastimes/clothing/ui/buyer/BuyerDashboardViewModel.kt`
- [Seller dashboard](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardFragment.kt): `app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardFragment.kt`
- [Seller state](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardViewModel.kt): `app/src/main/java/com/example/pastimes/clothing/ui/seller/SellerDashboardViewModel.kt`
- [Admin dashboard](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardFragment.kt): `app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardFragment.kt`
- [Admin state](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardViewModel.kt): `app/src/main/java/com/example/pastimes/clothing/ui/admin/AdminDashboardViewModel.kt`
- [List adapters](https://github.com/nasstyfox/pastimes-android/tree/master/app/src/main/java/com/example/pastimes/clothing/adapter): `app/src/main/java/com/example/pastimes/clothing/adapter`

### Commerce Data

- [Product repository](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/ProductRepository.kt): `app/src/main/java/com/example/pastimes/clothing/repository/ProductRepository.kt`
- [Cart repository](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/CartRepository.kt): `app/src/main/java/com/example/pastimes/clothing/repository/CartRepository.kt`
- [Clothing models](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/data/ClothingModels.kt): `app/src/main/java/com/example/pastimes/clothing/data/ClothingModels.kt`
- [Admin repository](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/repository/AdminRepository.kt): `app/src/main/java/com/example/pastimes/clothing/repository/AdminRepository.kt`

### API Platform

- [API services](https://github.com/nasstyfox/pastimes-android/tree/master/app/src/main/java/com/example/pastimes/clothing/network): `app/src/main/java/com/example/pastimes/clothing/network`
- [Retrofit client](https://github.com/nasstyfox/pastimes-android/blob/master/app/src/main/java/com/example/pastimes/clothing/network/RetrofitClient.kt): `app/src/main/java/com/example/pastimes/clothing/network/RetrofitClient.kt`

### Other components

- **App user**
- **Commerce backend**

## Connections

- App user → Login: signs in
- App user → Registration: registers
- Login → Auth state: submits credentials
- Registration → Auth state: creates account
- Auth state → Auth repository: requests auth
- Auth repository → API services: uses API
- Auth repository → Token storage: stores token
- Main navigation → Buyer dashboard: shows role view
- Main navigation → Seller dashboard: shows role view
- Main navigation → Admin dashboard: shows role view
- Buyer dashboard → Buyer state: uses state
- Seller dashboard → Seller state: uses state
- Admin dashboard → Admin state: uses state
- Buyer state → Product repository: loads products
- Buyer state → Cart repository: manages cart
- Seller state → Product repository: manages products
- Admin state → Admin repository: manages users
- Buyer dashboard → List adapters: renders lists
- Admin dashboard → List adapters: renders users
- Product repository → API services: uses API
- Cart repository → API services: uses API
- Admin repository → API services: uses API
- API services → Retrofit client: uses client
- Retrofit client → Commerce backend: sends requests
- Product repository → Clothing models: uses models
