How baarhavigit/flowhub works
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: App.tsx React application · api.ts HTTP client · WorkflowService.java Workflow service · AuthService.java Auth service
Components 27
Marketplace discovery
- React application
frontend/src/App.tsx - Home
frontend/src/pages/Home.tsx - Explore
frontend/src/pages/Explore.tsx - Workflow details
frontend/src/pages/WorkflowDetails.tsx - Workflow cards
frontend/src/components/WorkflowCard.tsx
Accounts and security
- Login
frontend/src/pages/Login.tsx - Register
frontend/src/pages/Register.tsx - Auth state
frontend/src/context/AuthContext.tsx - Auth routes
backend/src/main/java/com/flowhub/backend/controller/AuthController.java - Auth service
backend/src/main/java/com/flowhub/backend/service/AuthService.java - User repository
backend/src/main/java/com/flowhub/backend/repository/UserRepository.java - User account
backend/src/main/java/com/flowhub/backend/entity/User.java - JWT filter
backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java - User details
backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java - JWT provider
backend/src/main/java/com/flowhub/backend/security/JwtTokenProvider.java
Workflow catalog
- HTTP client
frontend/src/lib/api.ts - Workflow upload
frontend/src/pages/Upload.tsx - Spring API
backend/src/main/java/com/flowhub/backend - Workflow routes
backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java - Workflow service
backend/src/main/java/com/flowhub/backend/service/WorkflowService.java - Workflow repository
backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java - Workflow metadata
backend/src/main/java/com/flowhub/backend/entity/Workflow.java - Workflow files
backend/src/main/java/com/flowhub/backend/service/WorkflowService.java - PostgreSQL
Deployment integration
- n8n service
backend/src/main/java/com/flowhub/backend/service/N8nService.java - n8n
Other components
- Visitor or creator
Connections 33
- Visitor or creator → React application: uses
- React application → Home: routes to
frontend/src/App.tsx - React application → Explore: routes to
frontend/src/App.tsx - React application → Workflow details: routes to
frontend/src/App.tsx - React application → Workflow upload: routes to
frontend/src/App.tsx - React application → Login: routes to
frontend/src/App.tsx - React application → Register: routes to
frontend/src/App.tsx - Home → HTTP client: fetches workflows
frontend/src/pages/Home.tsx - Explore → HTTP client: requests catalog
frontend/src/pages/Explore.tsx - Workflow upload → HTTP client: submits upload
frontend/src/pages/Upload.tsx - Login → Auth state: sets session
frontend/src/pages/Login.tsx - Register → HTTP client: submits account
frontend/src/pages/Register.tsx - Home → Workflow cards: renders
frontend/src/pages/Home.tsx - Explore → Workflow cards: renders
frontend/src/pages/Explore.tsx - HTTP client → Spring API: HTTP requests
- Spring API → Workflow routes: serves routes
backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java - Workflow routes → Workflow service: delegates
backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java - Workflow service → Workflow repository: queries and saves
backend/src/main/java/com/flowhub/backend/service/WorkflowService.java - Workflow repository → Workflow metadata: persists
backend/src/main/java/com/flowhub/backend/repository/WorkflowRepository.java - Workflow service → Workflow files: reads and writes
backend/src/main/java/com/flowhub/backend/service/WorkflowService.java - Workflow repository → PostgreSQL: JPA persistence
- Workflow routes → Auth service: deployment calls
backend/src/main/java/com/flowhub/backend/controller/WorkflowController.java - Auth routes → Auth service: delegates
backend/src/main/java/com/flowhub/backend/controller/AuthController.java - Auth service → User repository: checks and saves
backend/src/main/java/com/flowhub/backend/service/AuthService.java - User repository → User account: persists
backend/src/main/java/com/flowhub/backend/repository/UserRepository.java - User repository → PostgreSQL: JPA persistence
- Auth service → JWT provider: creates token
backend/src/main/java/com/flowhub/backend/service/AuthService.java - JWT filter → JWT provider: validates token
backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java - JWT filter → User details: loads principal
backend/src/main/java/com/flowhub/backend/security/JwtAuthenticationFilter.java - User details → User repository: looks up user
backend/src/main/java/com/flowhub/backend/security/CustomUserDetailsService.java - Workflow service → n8n service: deploys and checks
backend/src/main/java/com/flowhub/backend/service/WorkflowService.java - n8n service → n8n: API calls
backend/src/main/java/com/flowhub/backend/service/N8nService.java - n8n → PostgreSQL: uses n8n schema