# baarhavigit/flowhub architecture

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

- Interactive diagram: https://gitdiagram.com/baarhavigit/flowhub
- Repository: https://github.com/baarhavigit/flowhub

## Overview

FlowHub is an n8n workflow marketplace: visitors browse and search workflows, users can register or log in, and authenticated creators upload workflow JSON. The backend stores workflow metadata and uploaded files, supports downloads and deployment/status operations, and can integrate with n8n. The README describes the current deploy endpoint as mocked, while the sampled N8nService contains real n8n API calls; the graph shows that implementation but does not imply every deployment path uses it. Some frontend and backend relationships are based on the README or source-index references rather than full source excerpts.

Main entry points: [`frontend/src/App.tsx`](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/App.tsx) (React application), [`frontend/src/lib/api.ts`](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/lib/api.ts) (HTTP client), [`backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/WorkflowService.java) (Workflow service), [`backend/src/main/java/com/flowhub/backend/service/AuthService.java`](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/AuthService.java) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Marketplace discovery"]
  node_spa["React application<br/>[App.tsx]"]
  node_home["Home<br/>[Home.tsx]"]
  node_explore["Explore<br/>[Explore.tsx]"]
  node_details["Workflow details"]
  node_cards["Workflow cards<br/>[WorkflowCard.tsx]"]
end

subgraph group_identity["Accounts and security"]
  node_login["Login<br/>[Login.tsx]"]
  node_register["Register<br/>[Register.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_authcontroller["Auth routes"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_userrepo["User repository"]
  node_userentity["User account<br/>[User.java]"]
  node_jwtfilter["JWT filter"]
  node_userdetails["User details"]
  node_jwttoken["JWT provider"]
end

subgraph group_catalog["Workflow catalog"]
  node_httpclient["HTTP client<br/>[api.ts]"]
  node_upload["Workflow upload<br/>[Upload.tsx]"]
  node_backend["Spring API"]
  node_workflowcontroller["Workflow routes"]
  node_workflowservice["Workflow service"]
  node_workflowrepo["Workflow repository"]
  node_workflowentity["Workflow metadata<br/>[Workflow.java]"]
  node_files["Workflow files"]
  node_postgres[("PostgreSQL")]
end

subgraph group_deployment["Deployment integration"]
  node_n8nservice["n8n service<br/>[N8nService.java]"]
  node_n8n["n8n"]
end

node_visitor(("Visitor or creator"))

node_visitor -->|"uses"| node_spa
node_spa -->|"routes to"| node_home
node_spa -->|"routes to"| node_explore
node_spa -->|"routes to"| node_details
node_spa -->|"routes to"| node_upload
node_spa -->|"routes to"| node_login
node_spa -->|"routes to"| node_register
node_home -->|"fetches workflows"| node_httpclient
node_explore -->|"requests catalog"| node_httpclient
node_upload -->|"submits upload"| node_httpclient
node_login -->|"sets session"| node_authstate
node_register -->|"submits account"| node_httpclient
node_home -->|"renders"| node_cards
node_explore -->|"renders"| node_cards
node_httpclient -->|"HTTP requests"| node_backend
node_backend -.->|"serves routes"| node_workflowcontroller
node_workflowcontroller -->|"delegates"| node_workflowservice
node_workflowservice -->|"queries and saves"| node_workflowrepo
node_workflowrepo -->|"persists"| node_workflowentity
node_workflowservice -->|"reads and writes"| node_files
node_workflowrepo -->|"JPA persistence"| node_postgres
node_workflowcontroller -->|"deployment calls"| node_authservice
node_authcontroller -->|"delegates"| node_authservice
node_authservice -->|"checks and saves"| node_userrepo
node_userrepo -->|"persists"| node_userentity
node_userrepo -->|"JPA persistence"| node_postgres
node_authservice -->|"creates token"| node_jwttoken
node_jwtfilter -->|"validates token"| node_jwttoken
node_jwtfilter -->|"loads principal"| node_userdetails
node_userdetails -->|"looks up user"| node_userrepo
node_workflowservice -->|"deploys and checks"| node_n8nservice
node_n8nservice -->|"API calls"| node_n8n
node_n8n -->|"uses n8n schema"| node_postgres

click node_spa "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/App.tsx"
click node_home "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Home.tsx"
click node_explore "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Explore.tsx"
click node_details "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/WorkflowDetails.tsx"
click node_cards "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/components/WorkflowCard.tsx"
click node_login "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Login.tsx"
click node_register "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Register.tsx"
click node_authstate "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/context/AuthContext.tsx"
click node_httpclient "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/lib/api.ts"
click node_upload "https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Upload.tsx"
click node_backend "https://github.com/baarhavigit/flowhub/tree/main/backend/src/main/java/com/flowhub/backend"
click node_workflowcontroller "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java"
click node_workflowservice "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/WorkflowService.java"
click node_workflowrepo "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java"
click node_workflowentity "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/entity/Workflow.java"
click node_files "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/WorkflowService.java"
click node_authcontroller "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/controller/AuthController.java"
click node_authservice "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/AuthService.java"
click node_userrepo "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/repository/UserRepository.java"
click node_userentity "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/entity/User.java"
click node_jwtfilter "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java"
click node_userdetails "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java"
click node_jwttoken "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/JwtTokenProvider.java"
click node_n8nservice "https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/N8nService.java"

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_spa,node_home,node_explore,node_details,node_cards toneBlue
class node_login,node_register,node_authstate,node_authcontroller,node_authservice,node_userrepo,node_userentity,node_jwtfilter,node_userdetails,node_jwttoken toneAmber
class node_httpclient,node_upload,node_backend,node_workflowcontroller,node_workflowservice,node_workflowrepo,node_workflowentity,node_files,node_postgres toneMint
class node_n8nservice,node_n8n toneRose
class node_visitor toneIndigo
```

## Components

### Marketplace discovery

- [React application](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Home](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Explore](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Explore.tsx): `frontend/src/pages/Explore.tsx`
- [Workflow details](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/WorkflowDetails.tsx): `frontend/src/pages/WorkflowDetails.tsx`
- [Workflow cards](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/components/WorkflowCard.tsx): `frontend/src/components/WorkflowCard.tsx`

### Accounts and security

- [Login](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Register](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Register.tsx): `frontend/src/pages/Register.tsx`
- [Auth state](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Auth routes](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/controller/AuthController.java): `backend/src/main/java/com/flowhub/backend/controller/AuthController.java`
- [Auth service](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/AuthService.java): `backend/src/main/java/com/flowhub/backend/service/AuthService.java`
- [User repository](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/repository/UserRepository.java): `backend/src/main/java/com/flowhub/backend/repository/UserRepository.java`
- [User account](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/entity/User.java): `backend/src/main/java/com/flowhub/backend/entity/User.java`
- [JWT filter](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java): `backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java`
- [User details](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java): `backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java`
- [JWT provider](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/security/JwtTokenProvider.java): `backend/src/main/java/com/flowhub/backend/security/JwtTokenProvider.java`

### Workflow catalog

- [HTTP client](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Workflow upload](https://github.com/baarhavigit/flowhub/blob/main/frontend/src/pages/Upload.tsx): `frontend/src/pages/Upload.tsx`
- [Spring API](https://github.com/baarhavigit/flowhub/tree/main/backend/src/main/java/com/flowhub/backend): `backend/src/main/java/com/flowhub/backend`
- [Workflow routes](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java): `backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java`
- [Workflow service](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/WorkflowService.java): `backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`
- [Workflow repository](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java): `backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java`
- [Workflow metadata](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/entity/Workflow.java): `backend/src/main/java/com/flowhub/backend/entity/Workflow.java`
- [Workflow files](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/WorkflowService.java): `backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`
- **PostgreSQL**

### Deployment integration

- [n8n service](https://github.com/baarhavigit/flowhub/blob/main/backend/src/main/java/com/flowhub/backend/service/N8nService.java): `backend/src/main/java/com/flowhub/backend/service/N8nService.java`
- **n8n**

### Other components

- **Visitor or creator**

## Connections

- Visitor or creator → React application: uses
- React application → Home: routes to (evidence: `frontend/src/App.tsx`)
- React application → Explore: routes to (evidence: `frontend/src/App.tsx`)
- React application → Workflow details: routes to (evidence: `frontend/src/App.tsx`)
- React application → Workflow upload: routes to (evidence: `frontend/src/App.tsx`)
- React application → Login: routes to (evidence: `frontend/src/App.tsx`)
- React application → Register: routes to (evidence: `frontend/src/App.tsx`)
- Home → HTTP client: fetches workflows (evidence: `frontend/src/pages/Home.tsx`)
- Explore → HTTP client: requests catalog (evidence: `frontend/src/pages/Explore.tsx`)
- Workflow upload → HTTP client: submits upload (evidence: `frontend/src/pages/Upload.tsx`)
- Login → Auth state: sets session (evidence: `frontend/src/pages/Login.tsx`)
- Register → HTTP client: submits account (evidence: `frontend/src/pages/Register.tsx`)
- Home → Workflow cards: renders (evidence: `frontend/src/pages/Home.tsx`)
- Explore → Workflow cards: renders (evidence: `frontend/src/pages/Explore.tsx`)
- HTTP client → Spring API: HTTP requests
- Spring API → Workflow routes: serves routes (evidence: `backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java`)
- Workflow routes → Workflow service: delegates (evidence: `backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java`)
- Workflow service → Workflow repository: queries and saves (evidence: `backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`)
- Workflow repository → Workflow metadata: persists (evidence: `backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java`)
- Workflow service → Workflow files: reads and writes (evidence: `backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`)
- Workflow repository → PostgreSQL: JPA persistence
- Workflow routes → Auth service: deployment calls (evidence: `backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java`)
- Auth routes → Auth service: delegates (evidence: `backend/src/main/java/com/flowhub/backend/controller/AuthController.java`)
- Auth service → User repository: checks and saves (evidence: `backend/src/main/java/com/flowhub/backend/service/AuthService.java`)
- User repository → User account: persists (evidence: `backend/src/main/java/com/flowhub/backend/repository/UserRepository.java`)
- User repository → PostgreSQL: JPA persistence
- Auth service → JWT provider: creates token (evidence: `backend/src/main/java/com/flowhub/backend/service/AuthService.java`)
- JWT filter → JWT provider: validates token (evidence: `backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java`)
- JWT filter → User details: loads principal (evidence: `backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java`)
- User details → User repository: looks up user (evidence: `backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java`)
- Workflow service → n8n service: deploys and checks (evidence: `backend/src/main/java/com/flowhub/backend/service/WorkflowService.java`)
- n8n service → n8n: API calls (evidence: `backend/src/main/java/com/flowhub/backend/service/N8nService.java`)
- n8n → PostgreSQL: uses n8n schema
