# nimasoltanm/neve architecture

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

- Interactive diagram: https://gitdiagram.com/nimasoltanm/neve
- Repository: https://github.com/nimasoltanm/neve

## Overview

This is a TanStack Router marketplace application with buyer, seller, and account workflows. Buyers browse marketplace categories and products, then use cart, checkout, orders, and auction bidding; sellers manage shops, products, auctions, and orders, with dashboard analytics. Authentication gates account and seller areas. The graph reflects visible route wiring and documented route structure; several feature internals were not sampled, so their connections are shown as unverified rather than asserted.

Main entry points: [`src/routes/(root)/route.tsx`](https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/route.tsx) (Public layout), [`src/routes/(dashboards)/shop/route.tsx`](https://github.com/nimasoltanm/neve/blob/master/src/routes/(dashboards)/shop/route.tsx) (Seller gate), [`src/routes/(root)/(marketplace)/marketplace/index.tsx`](https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/(marketplace)/marketplace/index.tsx) (Marketplace route), [`src/features/auth/actions/get-current-user.action.ts`](https://github.com/nimasoltanm/neve/blob/master/src/features/auth/actions/get-current-user.action.ts) (Authentication actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_rootlayout["Public layout<br/>[route.tsx]"]
  node_dashboardlayout["Dashboard gate<br/>[route.tsx]"]
  node_shoplayout["Seller gate<br/>[route.tsx]"]
  node_header["Site header<br/>[header.tsx]"]
end

subgraph group_marketplace["Marketplace"]
  node_marketroute["Marketplace route<br/>[index.tsx]"]
  node_products["Product catalog<br/>[actions.ts]"]
  node_categories["Categories<br/>[actions.ts]"]
  node_bids["Auction bidding"]
end

subgraph group_commerce["Buyer commerce"]
  node_cart["Shopping cart"]
  node_checkout["Checkout<br/>[checkout-form.tsx]"]
  node_orders["Order processing"]
end

subgraph group_seller["Seller workspace"]
  node_productmanagement["Product management"]
  node_shops["Shop operations<br/>[actions.ts]"]
  node_analytics["Shop analytics"]
end

subgraph group_platform["Account and platform"]
  node_authroute["Authentication route<br/>[index.tsx]"]
  node_auth["Authentication actions"]
  node_authschema["Account schema<br/>[auth.schema.ts]"]
  node_database[("Application database<br/>[index.ts]")]
  node_notifications["Notifications"]
  node_upload["File uploads"]
  node_i18n["Localization<br/>[context.tsx]"]
  node_preview["Guided preview<br/>[preview-panel.tsx]"]
end

node_visitor(("Visitor or user"))

node_visitor -->|"opens app"| node_rootlayout
node_rootlayout -->|"renders"| node_header
node_rootlayout -.->|"hosts routes"| node_marketroute
node_visitor -.->|"browses"| node_marketroute
node_marketroute -->|"loads products"| node_products
node_marketroute -->|"loads categories"| node_categories
node_marketroute -->|"offers bidding"| node_bids
node_header -->|"shows cart"| node_cart
node_visitor -.->|"manages cart"| node_cart
node_cart -.->|"continues checkout"| node_checkout
node_checkout -.->|"creates order"| node_orders
node_visitor -.->|"signs in"| node_authroute
node_authroute -.->|"uses actions"| node_auth
node_dashboardlayout -->|"checks identity"| node_auth
node_shoplayout -->|"checks identity"| node_auth
node_shoplayout -->|"checks shop"| node_shops
node_visitor -.->|"opens dashboard"| node_dashboardlayout
node_visitor -.->|"opens seller area"| node_shoplayout
node_shoplayout -.->|"hosts management"| node_productmanagement
node_shoplayout -.->|"hosts analytics"| node_analytics
node_auth -->|"reads user"| node_database
node_auth -->|"validates with"| node_authschema
node_database -->|"loads schema"| node_authschema
node_header -->|"shows notifications"| node_notifications
node_visitor -.->|"uploads files"| node_upload
node_rootlayout -->|"reads direction"| node_i18n
node_rootlayout -.->|"offers preview"| node_preview

click node_rootlayout "https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/route.tsx"
click node_dashboardlayout "https://github.com/nimasoltanm/neve/blob/master/src/routes/(dashboards)/dashboard/route.tsx"
click node_shoplayout "https://github.com/nimasoltanm/neve/blob/master/src/routes/(dashboards)/shop/route.tsx"
click node_header "https://github.com/nimasoltanm/neve/blob/master/src/features/shared/layout/components/header.tsx"
click node_marketroute "https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/(marketplace)/marketplace/index.tsx"
click node_products "https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/products/actions.ts"
click node_productmanagement "https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/products/actions/product-management.actions.ts"
click node_categories "https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/categories/actions.ts"
click node_shops "https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/shops/actions.ts"
click node_bids "https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/bids/actions/place-bid.action.ts"
click node_cart "https://github.com/nimasoltanm/neve/blob/master/src/features/cart/actions/add-to-cart.action.ts"
click node_checkout "https://github.com/nimasoltanm/neve/blob/master/src/features/orders/components/checkout-form.tsx"
click node_orders "https://github.com/nimasoltanm/neve/blob/master/src/features/orders/actions/create-order.action.ts"
click node_authroute "https://github.com/nimasoltanm/neve/blob/master/src/routes/auth/index.tsx"
click node_auth "https://github.com/nimasoltanm/neve/blob/master/src/features/auth/actions/get-current-user.action.ts"
click node_authschema "https://github.com/nimasoltanm/neve/blob/master/src/features/auth/schemas/auth.schema.ts"
click node_database "https://github.com/nimasoltanm/neve/blob/master/src/server/db/index.ts"
click node_notifications "https://github.com/nimasoltanm/neve/blob/master/src/features/notifications/actions/get-notifications.action.ts"
click node_analytics "https://github.com/nimasoltanm/neve/blob/master/src/features/analytics/actions/get-analytics-data.action.ts"
click node_upload "https://github.com/nimasoltanm/neve/blob/master/src/features/shared/upload/actions/upload-file.action.ts"
click node_i18n "https://github.com/nimasoltanm/neve/blob/master/src/features/shared/i18n/context.tsx"
click node_preview "https://github.com/nimasoltanm/neve/blob/master/src/features/preview-mode/components/preview-panel.tsx"

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_rootlayout,node_dashboardlayout,node_shoplayout,node_header,node_visitor toneBlue
class node_marketroute,node_products,node_categories,node_bids toneAmber
class node_cart,node_checkout,node_orders toneMint
class node_productmanagement,node_shops,node_analytics toneRose
class node_authroute,node_auth,node_authschema,node_database,node_notifications,node_upload,node_i18n,node_preview toneIndigo
```

## Components

### App navigation

- [Public layout](https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/route.tsx): `src/routes/(root)/route.tsx`
- [Dashboard gate](https://github.com/nimasoltanm/neve/blob/master/src/routes/(dashboards)/dashboard/route.tsx): `src/routes/(dashboards)/dashboard/route.tsx`
- [Seller gate](https://github.com/nimasoltanm/neve/blob/master/src/routes/(dashboards)/shop/route.tsx): `src/routes/(dashboards)/shop/route.tsx`
- [Site header](https://github.com/nimasoltanm/neve/blob/master/src/features/shared/layout/components/header.tsx): `src/features/shared/layout/components/header.tsx`

### Marketplace

- [Marketplace route](https://github.com/nimasoltanm/neve/blob/master/src/routes/(root)/(marketplace)/marketplace/index.tsx): `src/routes/(root)/(marketplace)/marketplace/index.tsx`
- [Product catalog](https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/products/actions.ts): `src/features/marketplace/products/actions.ts`
- [Categories](https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/categories/actions.ts): `src/features/marketplace/categories/actions.ts`
- [Auction bidding](https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/bids/actions/place-bid.action.ts): `src/features/marketplace/bids/actions/place-bid.action.ts`

### Buyer commerce

- [Shopping cart](https://github.com/nimasoltanm/neve/blob/master/src/features/cart/actions/add-to-cart.action.ts): `src/features/cart/actions/add-to-cart.action.ts`
- [Checkout](https://github.com/nimasoltanm/neve/blob/master/src/features/orders/components/checkout-form.tsx): `src/features/orders/components/checkout-form.tsx`
- [Order processing](https://github.com/nimasoltanm/neve/blob/master/src/features/orders/actions/create-order.action.ts): `src/features/orders/actions/create-order.action.ts`

### Seller workspace

- [Product management](https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/products/actions/product-management.actions.ts): `src/features/marketplace/products/actions/product-management.actions.ts`
- [Shop operations](https://github.com/nimasoltanm/neve/blob/master/src/features/marketplace/shops/actions.ts): `src/features/marketplace/shops/actions.ts`
- [Shop analytics](https://github.com/nimasoltanm/neve/blob/master/src/features/analytics/actions/get-analytics-data.action.ts): `src/features/analytics/actions/get-analytics-data.action.ts`

### Account and platform

- [Authentication route](https://github.com/nimasoltanm/neve/blob/master/src/routes/auth/index.tsx): `src/routes/auth/index.tsx`
- [Authentication actions](https://github.com/nimasoltanm/neve/blob/master/src/features/auth/actions/get-current-user.action.ts): `src/features/auth/actions/get-current-user.action.ts`
- [Account schema](https://github.com/nimasoltanm/neve/blob/master/src/features/auth/schemas/auth.schema.ts): `src/features/auth/schemas/auth.schema.ts`
- [Application database](https://github.com/nimasoltanm/neve/blob/master/src/server/db/index.ts): `src/server/db/index.ts`
- [Notifications](https://github.com/nimasoltanm/neve/blob/master/src/features/notifications/actions/get-notifications.action.ts): `src/features/notifications/actions/get-notifications.action.ts`
- [File uploads](https://github.com/nimasoltanm/neve/blob/master/src/features/shared/upload/actions/upload-file.action.ts): `src/features/shared/upload/actions/upload-file.action.ts`
- [Localization](https://github.com/nimasoltanm/neve/blob/master/src/features/shared/i18n/context.tsx): `src/features/shared/i18n/context.tsx`
- [Guided preview](https://github.com/nimasoltanm/neve/blob/master/src/features/preview-mode/components/preview-panel.tsx): `src/features/preview-mode/components/preview-panel.tsx`

### Other components

- **Visitor or user**

## Connections

- Visitor or user → Public layout: opens app (evidence: `src/routes/(root)/route.tsx`)
- Public layout → Site header: renders (evidence: `src/routes/(root)/route.tsx`)
- Public layout → Marketplace route: hosts routes
- Visitor or user → Marketplace route: browses
- Marketplace route → Product catalog: loads products (evidence: `src/routes/(root)/(marketplace)/marketplace/index.tsx`)
- Marketplace route → Categories: loads categories (evidence: `src/routes/(root)/(marketplace)/marketplace/index.tsx`)
- Marketplace route → Auction bidding: offers bidding (evidence: `src/routes/(root)/(marketplace)/marketplace/index.tsx`)
- Site header → Shopping cart: shows cart (evidence: `src/features/shared/layout/components/header.tsx`)
- Visitor or user → Shopping cart: manages cart
- Shopping cart → Checkout: continues checkout
- Checkout → Order processing: creates order
- Visitor or user → Authentication route: signs in
- Authentication route → Authentication actions: uses actions
- Dashboard gate → Authentication actions: checks identity (evidence: `src/routes/(dashboards)/dashboard/route.tsx`)
- Seller gate → Authentication actions: checks identity (evidence: `src/routes/(dashboards)/shop/route.tsx`)
- Seller gate → Shop operations: checks shop (evidence: `src/routes/(dashboards)/shop/route.tsx`)
- Visitor or user → Dashboard gate: opens dashboard
- Visitor or user → Seller gate: opens seller area
- Seller gate → Product management: hosts management
- Seller gate → Shop analytics: hosts analytics
- Authentication actions → Application database: reads user (evidence: `src/features/auth/actions/get-current-user.action.ts`)
- Authentication actions → Account schema: validates with (evidence: `src/features/auth/actions/get-current-user.action.ts`)
- Application database → Account schema: loads schema (evidence: `src/server/db/index.ts`)
- Site header → Notifications: shows notifications (evidence: `src/features/shared/layout/components/header.tsx`)
- Visitor or user → File uploads: uploads files
- Public layout → Localization: reads direction (evidence: `src/routes/(root)/route.tsx`)
- Public layout → Guided preview: offers preview
