# 100xwinter-arc/bino architecture

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

- Interactive diagram: https://gitdiagram.com/100xwinter-arc/bino
- Repository: https://github.com/100xwinter-arc/bino

## Overview

Bino is a Binance-themed web app with a React frontend and an Express backend. The visible workflow is session checking and account signup/signin, followed by protected profile or stocks pages; the backend validates credentials, persists users, and manages cookie sessions. Signup also attempts a welcome email. The README names a Binance frontend, but the supplied source excerpts show no market-data integration or trading behavior, so the stocks branch is represented as a page rather than an inferred exchange pipeline.

Main entry points: [`frontend/src/App.tsx`](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/App.tsx) (App routing), [`backend/src/controllers/auth.controller.ts`](https://github.com/100xwinter-arc/bino/blob/main/backend/src/controllers/auth.controller.ts) (Auth controller), [`backend/src/lib/env.ts`](https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/env.ts) (Environment config), [`backend/src/index.ts`](https://github.com/100xwinter-arc/bino/blob/main/backend/src/index.ts) (Server setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web frontend"]
  node_app["App routing<br/>[App.tsx]"]
  node_layout["Page layout<br/>[PageLayout.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_authform["Auth form<br/>[AuthForm.tsx]"]
  node_guard["Route guard<br/>[ProtectedRoute.tsx]"]
  node_home["Home page<br/>[Home.tsx]"]
  node_login["Login page<br/>[Login.tsx]"]
  node_signup["Signup page<br/>[Signup.tsx]"]
  node_profile["Profile page<br/>[Profile.tsx]"]
  node_stocks["Stocks page<br/>[Stocks.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_authstate["Auth state<br/>[useAuthStore.ts]"]
end

subgraph group_backend["Auth backend"]
  node_server["Server setup<br/>[index.ts]"]
  node_routes["Auth routes<br/>[auth.routes.ts]"]
  node_controller["Auth controller<br/>[auth.controller.ts]"]
  node_validation["Input validation<br/>[validation.ts]"]
  node_user["User model<br/>[user.model.ts]"]
  node_session["Session cookies<br/>[session.ts]"]
  node_middleware["Auth middleware<br/>[auth.middleware.ts]"]
  node_email["Welcome email<br/>[email.ts]"]
end

subgraph group_integrations["Services and state"]
  node_env["Environment config<br/>[env.ts]"]
  node_database["Database connection<br/>[db.ts]"]
  node_emailservice["Email provider"]
end

node_visitor(("Visitor"))

node_visitor -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"guards"| node_profile
node_app -->|"guards"| node_stocks
node_app -->|"checks session"| node_api
node_app -->|"updates"| node_authstate
node_layout -->|"renders"| node_nav
node_login -.->|"renders"| node_authform
node_signup -.->|"renders"| node_authform
node_authform -->|"submits credentials"| node_api
node_authform -->|"sets user"| node_authstate
node_nav -->|"requests logout"| node_api
node_nav -->|"updates"| node_authstate
node_guard -->|"reads state"| node_authstate
node_app -->|"wraps routes"| node_guard
node_api -.->|"sends HTTP requests"| node_server
node_server -->|"loads config"| node_env
node_server -->|"initializes"| node_database
node_server -->|"mounts"| node_routes
node_routes -->|"dispatches"| node_controller
node_routes -->|"protects session route"| node_middleware
node_controller -->|"validates input"| node_validation
node_controller -->|"reads and writes"| node_user
node_controller -->|"creates or clears"| node_session
node_middleware -->|"uses cookie name"| node_session
node_controller -->|"sends welcome"| node_email
node_email -.->|"sends email"| node_emailservice
node_email -->|"reads settings"| node_env
node_session -->|"reads secret"| node_env
node_middleware -->|"reads secret"| node_env
node_database -->|"reads settings"| node_env

click node_app "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/App.tsx"
click node_layout "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/PageLayout.tsx"
click node_nav "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/Navbar.tsx"
click node_authform "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/AuthForm.tsx"
click node_guard "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/ProtectedRoute.tsx"
click node_home "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Home.tsx"
click node_login "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Login.tsx"
click node_signup "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Signup.tsx"
click node_profile "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Profile.tsx"
click node_stocks "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Stocks.tsx"
click node_api "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/lib/api.ts"
click node_authstate "https://github.com/100xwinter-arc/bino/blob/main/frontend/src/store/useAuthStore.ts"
click node_server "https://github.com/100xwinter-arc/bino/blob/main/backend/src/index.ts"
click node_routes "https://github.com/100xwinter-arc/bino/blob/main/backend/src/routes/auth.routes.ts"
click node_controller "https://github.com/100xwinter-arc/bino/blob/main/backend/src/controllers/auth.controller.ts"
click node_validation "https://github.com/100xwinter-arc/bino/blob/main/backend/src/utils/validation.ts"
click node_user "https://github.com/100xwinter-arc/bino/blob/main/backend/src/models/user.model.ts"
click node_session "https://github.com/100xwinter-arc/bino/blob/main/backend/src/utils/session.ts"
click node_middleware "https://github.com/100xwinter-arc/bino/blob/main/backend/src/middlewares/auth.middleware.ts"
click node_email "https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/email.ts"
click node_env "https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/env.ts"
click node_database "https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/db.ts"

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_layout,node_nav,node_authform,node_guard,node_home,node_login,node_signup,node_profile,node_stocks,node_api,node_authstate toneBlue
class node_server,node_routes,node_controller,node_validation,node_user,node_session,node_middleware,node_email toneAmber
class node_env,node_database,node_emailservice toneMint
class node_visitor toneIndigo
```

## Components

### Web frontend

- [App routing](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Page layout](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/PageLayout.tsx): `frontend/src/components/PageLayout.tsx`
- [Navigation](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/Navbar.tsx): `frontend/src/components/Navbar.tsx`
- [Auth form](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/AuthForm.tsx): `frontend/src/components/AuthForm.tsx`
- [Route guard](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/components/ProtectedRoute.tsx): `frontend/src/components/ProtectedRoute.tsx`
- [Home page](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Login page](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Signup page](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Signup.tsx): `frontend/src/pages/Signup.tsx`
- [Profile page](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Profile.tsx): `frontend/src/pages/Profile.tsx`
- [Stocks page](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/pages/Stocks.tsx): `frontend/src/pages/Stocks.tsx`
- [API client](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Auth state](https://github.com/100xwinter-arc/bino/blob/main/frontend/src/store/useAuthStore.ts): `frontend/src/store/useAuthStore.ts`

### Auth backend

- [Server setup](https://github.com/100xwinter-arc/bino/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Auth routes](https://github.com/100xwinter-arc/bino/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Auth controller](https://github.com/100xwinter-arc/bino/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Input validation](https://github.com/100xwinter-arc/bino/blob/main/backend/src/utils/validation.ts): `backend/src/utils/validation.ts`
- [User model](https://github.com/100xwinter-arc/bino/blob/main/backend/src/models/user.model.ts): `backend/src/models/user.model.ts`
- [Session cookies](https://github.com/100xwinter-arc/bino/blob/main/backend/src/utils/session.ts): `backend/src/utils/session.ts`
- [Auth middleware](https://github.com/100xwinter-arc/bino/blob/main/backend/src/middlewares/auth.middleware.ts): `backend/src/middlewares/auth.middleware.ts`
- [Welcome email](https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/email.ts): `backend/src/lib/email.ts`

### Services and state

- [Environment config](https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/env.ts): `backend/src/lib/env.ts`
- [Database connection](https://github.com/100xwinter-arc/bino/blob/main/backend/src/lib/db.ts): `backend/src/lib/db.ts`
- **Email provider**

### Other components

- **Visitor**

## Connections

- Visitor → App routing: uses
- App routing → Page layout: renders (evidence: `frontend/src/App.tsx`)
- App routing → Home page: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Login page: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Signup page: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Profile page: guards (evidence: `frontend/src/App.tsx`)
- App routing → Stocks page: guards (evidence: `frontend/src/App.tsx`)
- App routing → API client: checks session (evidence: `frontend/src/App.tsx`)
- App routing → Auth state: updates (evidence: `frontend/src/App.tsx`)
- Page layout → Navigation: renders (evidence: `frontend/src/components/PageLayout.tsx`)
- Login page → Auth form: renders
- Signup page → Auth form: renders
- Auth form → API client: submits credentials (evidence: `frontend/src/components/AuthForm.tsx`)
- Auth form → Auth state: sets user (evidence: `frontend/src/components/AuthForm.tsx`)
- Navigation → API client: requests logout (evidence: `frontend/src/components/Navbar.tsx`)
- Navigation → Auth state: updates (evidence: `frontend/src/components/Navbar.tsx`)
- Route guard → Auth state: reads state (evidence: `frontend/src/components/ProtectedRoute.tsx`)
- App routing → Route guard: wraps routes (evidence: `frontend/src/App.tsx`)
- API client → Server setup: sends HTTP requests
- Server setup → Environment config: loads config (evidence: `backend/src/index.ts`)
- Server setup → Database connection: initializes (evidence: `backend/src/index.ts`)
- Server setup → Auth routes: mounts (evidence: `backend/src/index.ts`)
- Auth routes → Auth controller: dispatches (evidence: `backend/src/routes/auth.routes.ts`)
- Auth routes → Auth middleware: protects session route (evidence: `backend/src/routes/auth.routes.ts`)
- Auth controller → Input validation: validates input (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth controller → User model: reads and writes (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth controller → Session cookies: creates or clears (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth middleware → Session cookies: uses cookie name (evidence: `backend/src/middlewares/auth.middleware.ts`)
- Auth controller → Welcome email: sends welcome (evidence: `backend/src/controllers/auth.controller.ts`)
- Welcome email → Email provider: sends email
- Welcome email → Environment config: reads settings (evidence: `backend/src/lib/email.ts`)
- Session cookies → Environment config: reads secret (evidence: `backend/src/utils/session.ts`)
- Auth middleware → Environment config: reads secret (evidence: `backend/src/middlewares/auth.middleware.ts`)
- Database connection → Environment config: reads settings (evidence: `backend/src/lib/db.ts`)
