# snehasish-tech/algofi architecture

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

- Interactive diagram: https://gitdiagram.com/snehasish-tech/algofi
- Repository: https://github.com/snehasish-tech/algofi

## Overview

AlgoFi is an Algorand NFT marketplace for creators and collectors. The main workflow is wallet connection, NFT minting or marketplace browsing, transaction preparation and submission, then portfolio or asset viewing. The frontend currently uses mock marketplace and portfolio data in places; the README documents broader API and contract capabilities. Backend excerpts show route dispatch, controller orchestration, and Algorand transaction services; unsampled implementation details are not inferred.

Main entry points: [`frontend/src/App.js`](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/App.js) (App & Wallet), [`backend/server.js`](https://github.com/snehasish-tech/algofi/blob/main/backend/server.js) (Express Server), [`backend/src/services/algorandService.js`](https://github.com/snehasish-tech/algofi/blob/main/backend/src/services/algorandService.js) (Algorand Service), [`frontend/src/components/NFTCard.js`](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/NFTCard.js) (NFT Card)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Marketplace UI"]
  node_app["App &amp; Wallet<br/>[App.js]"]
  node_header["Navigation<br/>[Header.js]"]
  node_home["Creator Home<br/>[Home.js]"]
  node_mint["Mint Form<br/>[MintForm.js]"]
  node_marketplace["Marketplace Browse<br/>[Marketplace.js]"]
  node_portfolio["NFT Portfolio<br/>[Portfolio.js]"]
  node_card["NFT Card<br/>[NFTCard.js]"]
  node_scroll["Scroll Control<br/>[ScrollToTop.js]"]
end

subgraph group_backend["NFT API"]
  node_api_server["Express Server<br/>[server.js]"]
  node_routes["NFT Routes<br/>[nftRoutes.js]"]
  node_controller["NFT Controller<br/>[nftController.js]"]
end

subgraph group_chain["Algorand Runtime"]
  node_algorand_service["Algorand Service<br/>[algorandService.js]"]
  node_algod(("Algorand TestNet"))
  node_contract["Marketplace Contract"]
end

subgraph group_appearance["App Preferences"]
  node_theme["Theme State<br/>[ThemeContext.js]"]
  node_theme_toggle["Theme Toggle<br/>[ThemeToggle.js]"]
end

node_creator(("Creator / Collector"))

node_creator -->|"uses"| node_app
node_app -->|"renders"| node_header
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_marketplace
node_app -->|"routes to"| node_portfolio
node_app -->|"renders"| node_scroll
node_home -->|"renders"| node_mint
node_marketplace -->|"renders"| node_card
node_portfolio -->|"renders"| node_card
node_header -->|"renders"| node_theme_toggle
node_theme_toggle -->|"reads and toggles"| node_theme
node_app -->|"provides context"| node_theme
node_creator -->|"submits mint"| node_mint
node_mint -->|"posts mint request"| node_api_server
node_creator -->|"initiates purchase"| node_card
node_card -->|"posts buy request"| node_api_server
node_portfolio -->|"requests account NFTs"| node_api_server
node_api_server -->|"mounts routes"| node_routes
node_routes -->|"dispatches requests"| node_controller
node_controller -->|"creates transactions"| node_algorand_service
node_controller -->|"submits signed transaction"| node_algorand_service
node_algorand_service -->|"queries and submits"| node_algod
node_algorand_service -->|"calls marketplace actions"| node_contract
node_contract -->|"runs on TestNet"| node_algod
node_marketplace -.->|"fetches listings"| node_api_server

click node_app "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/App.js"
click node_header "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/Header.js"
click node_home "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Home.js"
click node_mint "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/MintForm.js"
click node_marketplace "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Marketplace.js"
click node_portfolio "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Portfolio.js"
click node_card "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/NFTCard.js"
click node_scroll "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/ScrollToTop.js"
click node_theme "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/context/ThemeContext.js"
click node_theme_toggle "https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/ThemeToggle.js"
click node_api_server "https://github.com/snehasish-tech/algofi/blob/main/backend/server.js"
click node_routes "https://github.com/snehasish-tech/algofi/blob/main/backend/src/routes/nftRoutes.js"
click node_controller "https://github.com/snehasish-tech/algofi/blob/main/backend/src/controllers/nftController.js"
click node_algorand_service "https://github.com/snehasish-tech/algofi/blob/main/backend/src/services/algorandService.js"
click node_contract "https://github.com/snehasish-tech/algofi/blob/main/smart_contracts/algomint_contract.py"

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_app,node_header,node_home,node_mint,node_marketplace,node_portfolio,node_card,node_scroll toneBlue
class node_api_server,node_routes,node_controller toneAmber
class node_algorand_service,node_algod,node_contract toneMint
class node_theme,node_theme_toggle toneRose
class node_creator toneIndigo
```

## Components

### Marketplace UI

- [App & Wallet](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Navigation](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/Header.js): `frontend/src/components/Header.js`
- [Creator Home](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Home.js): `frontend/src/views/Home.js`
- [Mint Form](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/MintForm.js): `frontend/src/components/MintForm.js`
- [Marketplace Browse](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Marketplace.js): `frontend/src/views/Marketplace.js`
- [NFT Portfolio](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/views/Portfolio.js): `frontend/src/views/Portfolio.js`
- [NFT Card](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/NFTCard.js): `frontend/src/components/NFTCard.js`
- [Scroll Control](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/ScrollToTop.js): `frontend/src/components/ScrollToTop.js`

### NFT API

- [Express Server](https://github.com/snehasish-tech/algofi/blob/main/backend/server.js): `backend/server.js`
- [NFT Routes](https://github.com/snehasish-tech/algofi/blob/main/backend/src/routes/nftRoutes.js): `backend/src/routes/nftRoutes.js`
- [NFT Controller](https://github.com/snehasish-tech/algofi/blob/main/backend/src/controllers/nftController.js): `backend/src/controllers/nftController.js`

### Algorand Runtime

- [Algorand Service](https://github.com/snehasish-tech/algofi/blob/main/backend/src/services/algorandService.js): `backend/src/services/algorandService.js`
- **Algorand TestNet**
- [Marketplace Contract](https://github.com/snehasish-tech/algofi/blob/main/smart_contracts/algomint_contract.py): `smart_contracts/algomint_contract.py`

### App Preferences

- [Theme State](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/context/ThemeContext.js): `frontend/src/context/ThemeContext.js`
- [Theme Toggle](https://github.com/snehasish-tech/algofi/blob/main/frontend/src/components/ThemeToggle.js): `frontend/src/components/ThemeToggle.js`

### Other components

- **Creator / Collector**

## Connections

- Creator / Collector → App & Wallet: uses (evidence: `Readme.md`)
- App & Wallet → Navigation: renders (evidence: `frontend/src/App.js`)
- App & Wallet → Creator Home: routes to (evidence: `frontend/src/App.js`)
- App & Wallet → Marketplace Browse: routes to (evidence: `frontend/src/App.js`)
- App & Wallet → NFT Portfolio: routes to (evidence: `frontend/src/App.js`)
- App & Wallet → Scroll Control: renders (evidence: `frontend/src/App.js`)
- Creator Home → Mint Form: renders (evidence: `frontend/src/views/Home.js`)
- Marketplace Browse → NFT Card: renders (evidence: `frontend/src/views/Marketplace.js`)
- NFT Portfolio → NFT Card: renders (evidence: `frontend/src/views/Portfolio.js`)
- Navigation → Theme Toggle: renders (evidence: `frontend/src/components/Header.js`)
- Theme Toggle → Theme State: reads and toggles (evidence: `frontend/src/components/ThemeToggle.js`)
- App & Wallet → Theme State: provides context (evidence: `frontend/src/App.js`)
- Creator / Collector → Mint Form: submits mint (evidence: `Readme.md`)
- Mint Form → Express Server: posts mint request (evidence: `frontend/src/components/MintForm.js`)
- Creator / Collector → NFT Card: initiates purchase (evidence: `Readme.md`)
- NFT Card → Express Server: posts buy request (evidence: `frontend/src/components/NFTCard.js`)
- NFT Portfolio → Express Server: requests account NFTs (evidence: `frontend/src/views/Portfolio.js`)
- Express Server → NFT Routes: mounts routes (evidence: `backend/server.js`)
- NFT Routes → NFT Controller: dispatches requests (evidence: `backend/src/routes/nftRoutes.js`)
- NFT Controller → Algorand Service: creates transactions (evidence: `backend/src/controllers/nftController.js`)
- NFT Controller → Algorand Service: submits signed transaction (evidence: `backend/src/controllers/nftController.js`)
- Algorand Service → Algorand TestNet: queries and submits (evidence: `backend/src/services/algorandService.js`)
- Algorand Service → Marketplace Contract: calls marketplace actions (evidence: `Readme.md`)
- Marketplace Contract → Algorand TestNet: runs on TestNet (evidence: `Readme.md`)
- Marketplace Browse → Express Server: fetches listings
