# pronative-ai/ai-assisted-starter-pack architecture

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

- Interactive diagram: https://gitdiagram.com/pronative-ai/ai-assisted-starter-pack
- Repository: https://github.com/pronative-ai/ai-assisted-starter-pack

## Overview

This is a product-catalog web application. A browser loads the React app, which requests product data and renders a list of cards; the ASP.NET API exposes product endpoints backed by an in-memory repository. The repository also defines the product model and repository interface. The endpoint-to-API relationship is visible in startup code, but the frontend-to-endpoint link is inferred from the HTTP route and is marked unverified because no shown file connects both components.

Main entry points: [`src/frontend/src/features/products/ProductList.tsx`](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/ProductList.tsx) (Product list), [`src/backend/Api/Program.cs`](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Program.cs) (API startup), [`src/backend/Api/Features/Products/InMemoryProductRepository.cs`](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/InMemoryProductRepository.cs) (In-memory repository), [`src/backend/Api/Features/Products/ProductEndpoints.cs`](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/ProductEndpoints.cs) (Product endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web frontend"]
  node_web_entry["React entry<br/>[main.tsx]"]
  node_app["Catalog app<br/>[App.tsx]"]
  node_product_list["Product list<br/>[ProductList.tsx]"]
  node_product_api["Product API client<br/>[api.ts]"]
  node_product_card["Product card<br/>[ProductCard.tsx]"]
  node_product_types["Product types<br/>[types.ts]"]
end

subgraph group_api["Catalog API"]
  node_api_host["API startup<br/>[Program.cs]"]
  node_product_endpoints["Product endpoints"]
end

subgraph group_domain["Product data"]
  node_repository_interface["Repository contract"]
  node_memory_repository[("In-memory repository")]
  node_product_model["Product model<br/>[Product.cs]"]
end

node_visitor(("Catalog visitor"))

node_visitor -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_app
node_app -->|"renders"| node_product_list
node_product_list -->|"fetches"| node_product_api
node_product_list -->|"renders"| node_product_card
node_product_list -->|"uses"| node_product_types
node_product_card -->|"uses"| node_product_types
node_product_api -.->|"requests products"| node_product_endpoints
node_api_host -->|"maps"| node_product_endpoints
node_api_host -->|"registers"| node_repository_interface
node_api_host -->|"selects implementation"| node_memory_repository
node_product_endpoints -->|"uses"| node_repository_interface
node_memory_repository -->|"implements"| node_repository_interface
node_memory_repository -->|"stores"| node_product_model

click node_web_entry "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/main.tsx"
click node_app "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/App.tsx"
click node_product_list "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/ProductList.tsx"
click node_product_api "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/api.ts"
click node_product_card "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/ProductCard.tsx"
click node_product_types "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/types.ts"
click node_api_host "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Program.cs"
click node_product_endpoints "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/ProductEndpoints.cs"
click node_repository_interface "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/IProductRepository.cs"
click node_memory_repository "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/InMemoryProductRepository.cs"
click node_product_model "https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/Product.cs"

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_web_entry,node_app,node_product_list,node_product_api,node_product_card,node_product_types toneBlue
class node_api_host,node_product_endpoints toneAmber
class node_repository_interface,node_memory_repository,node_product_model toneMint
class node_visitor toneIndigo
```

## Components

### Web frontend

- [React entry](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/main.tsx): `src/frontend/src/main.tsx`
- [Catalog app](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/App.tsx): `src/frontend/src/App.tsx`
- [Product list](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/ProductList.tsx): `src/frontend/src/features/products/ProductList.tsx`
- [Product API client](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/api.ts): `src/frontend/src/features/products/api.ts`
- [Product card](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/ProductCard.tsx): `src/frontend/src/features/products/ProductCard.tsx`
- [Product types](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/frontend/src/features/products/types.ts): `src/frontend/src/features/products/types.ts`

### Catalog API

- [API startup](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Program.cs): `src/backend/Api/Program.cs`
- [Product endpoints](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/ProductEndpoints.cs): `src/backend/Api/Features/Products/ProductEndpoints.cs`

### Product data

- [Repository contract](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/IProductRepository.cs): `src/backend/Api/Features/Products/IProductRepository.cs`
- [In-memory repository](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/InMemoryProductRepository.cs): `src/backend/Api/Features/Products/InMemoryProductRepository.cs`
- [Product model](https://github.com/pronative-ai/ai-assisted-starter-pack/blob/main/src/backend/Api/Features/Products/Product.cs): `src/backend/Api/Features/Products/Product.cs`

### Other components

- **Catalog visitor**

## Connections

- Catalog visitor → React entry: opens
- React entry → Catalog app: renders (evidence: `src/frontend/src/main.tsx`)
- Catalog app → Product list: renders (evidence: `src/frontend/src/App.tsx`)
- Product list → Product API client: fetches (evidence: `src/frontend/src/features/products/ProductList.tsx`)
- Product list → Product card: renders (evidence: `src/frontend/src/features/products/ProductList.tsx`)
- Product list → Product types: uses (evidence: `src/frontend/src/features/products/ProductList.tsx`)
- Product card → Product types: uses (evidence: `src/frontend/src/features/products/ProductCard.tsx`)
- Product API client → Product endpoints: requests products
- API startup → Product endpoints: maps (evidence: `src/backend/Api/Program.cs`)
- API startup → Repository contract: registers (evidence: `src/backend/Api/Program.cs`)
- API startup → In-memory repository: selects implementation (evidence: `src/backend/Api/Program.cs`)
- Product endpoints → Repository contract: uses (evidence: `src/backend/Api/Features/Products/ProductEndpoints.cs`)
- In-memory repository → Repository contract: implements (evidence: `src/backend/Api/Features/Products/InMemoryProductRepository.cs`)
- In-memory repository → Product model: stores (evidence: `src/backend/Api/Features/Products/InMemoryProductRepository.cs`)
