# shekhar143542/next_flow architecture

> Architecture diagram of the GitHub repository shekhar143542/next_flow, 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/shekhar143542/next_flow
- Repository: https://github.com/shekhar143542/next_flow

## Overview

Nextflow is a visual studio for authoring, saving, running, and inspecting AI workflows. Users create or open a workflow, edit connected multimodal nodes, and autosave the graph through workflow APIs to PostgreSQL. A run request starts a Trigger.dev task, which orders nodes, evaluates node types, and calls Gemini for LLM nodes. The UI polls run status; completed outputs are persisted. The README documents these product stages and node capabilities; sampled sources confirm key store, API, executor, and persistence links, but not every editor interaction.

Main entry points: [`src/lib/prisma.ts`](https://github.com/shekhar143542/next_flow/blob/main/src/lib/prisma.ts) (Prisma client), [`src/app/(pages)/workflow/workflowEditor.tsx`](https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/workflow/workflowEditor.tsx) (Workflow editor), [`src/lib/workflowApi.ts`](https://github.com/shekhar143542/next_flow/blob/main/src/lib/workflowApi.ts) (Workflow API client), [`src/app/api/workflows/[workflowId]/route.ts`](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/%5BworkflowId%5D/route.ts) (Workflow CRUD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Workflow authoring"]
  node_editor["Workflow editor<br/>[workflowEditor.tsx]"]
  node_node_editor["Node editor<br/>[NodeEditor.tsx]"]
  node_node_views["Node views<br/>[nodes.tsx]"]
  node_workflow_store["Workflow state"]
  node_auto_save["Autosave"]
  node_load_workflow["Workflow loading<br/>[useLoadWorkflow.ts]"]
  node_workflow_api_client["Workflow API client<br/>[workflowApi.ts]"]
  node_workflow_list["Workflow listing<br/>[page.tsx]"]
  node_workflow_cards["Workflow cards<br/>[WorkflowCard.tsx]"]
end

subgraph group_api["Application APIs"]
  node_crud_api["Workflow CRUD<br/>[route.ts]"]
  node_collection_api["Workflow collection<br/>[route.ts]"]
  node_duplicate_api["Workflow duplication<br/>[route.ts]"]
  node_run_api["Run request<br/>[route.ts]"]
  node_status_api["Run status<br/>[route.ts]"]
end

subgraph group_execution["Workflow execution"]
  node_trigger_task["Trigger task<br/>[example.ts]"]
  node_node_execution["Node execution<br/>[example.ts]"]
end

subgraph group_persistence["Persistence"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL")]
  node_run_records["Run records<br/>[route.ts]"]
end

node_user(("User"))
node_gemini{{"Gemini"}}
node_clerk{{"Clerk auth"}}

node_user -->|"edits workflow"| node_editor
node_editor -.->|"updates state"| node_workflow_store
node_node_editor -->|"creates workflow"| node_workflow_api_client
node_editor -->|"autosaves changes"| node_auto_save
node_auto_save -->|"reads graph"| node_workflow_store
node_auto_save -->|"creates workflow"| node_collection_api
node_auto_save -->|"saves graph"| node_crud_api
node_workflow_api_client -->|"creates workflow"| node_collection_api
node_workflow_list -->|"renders cards"| node_workflow_cards
node_workflow_list -->|"lists workflows"| node_collection_api
node_workflow_cards -->|"renames or duplicates"| node_workflow_api_client
node_workflow_api_client -->|"updates or deletes"| node_crud_api
node_workflow_api_client -->|"duplicates workflow"| node_duplicate_api
node_editor -->|"loads workflow"| node_load_workflow
node_load_workflow -->|"fetches graph"| node_crud_api
node_load_workflow -->|"loads graph"| node_workflow_store
node_user -->|"starts run"| node_run_api
node_run_api -->|"starts task"| node_trigger_task
node_trigger_task -->|"executes nodes"| node_node_execution
node_node_execution -->|"generates content"| node_gemini
node_user -->|"polls run"| node_status_api
node_status_api -->|"retrieves run"| node_trigger_task
node_status_api -->|"persists completion"| node_run_records
node_run_records -->|"upserts output"| node_prisma
node_collection_api -->|"reads or creates"| node_prisma
node_crud_api -->|"reads or writes"| node_prisma
node_duplicate_api -->|"duplicates data"| node_prisma
node_trigger_task -->|"loads workflow"| node_prisma
node_prisma -->|"queries database"| node_postgres
node_collection_api -->|"authenticates user"| node_clerk
node_crud_api -->|"authenticates user"| node_clerk
node_status_api -->|"returns status"| node_user
node_node_views -.->|"renders nodes"| node_editor

click node_editor "https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/workflow/workflowEditor.tsx"
click node_node_editor "https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/editor/NodeEditor.tsx"
click node_node_views "https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/workflow/components/nodes.tsx"
click node_workflow_store "https://github.com/shekhar143542/next_flow/blob/main/src/store/useWorkflowStore.ts"
click node_auto_save "https://github.com/shekhar143542/next_flow/blob/main/src/hooks/useAutoSaveWorkflow.ts"
click node_load_workflow "https://github.com/shekhar143542/next_flow/blob/main/src/hooks/useLoadWorkflow.ts"
click node_workflow_api_client "https://github.com/shekhar143542/next_flow/blob/main/src/lib/workflowApi.ts"
click node_workflow_list "https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/editor/page.tsx"
click node_workflow_cards "https://github.com/shekhar143542/next_flow/blob/main/src/components/WorkflowCard.tsx"
click node_crud_api "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/%5BworkflowId%5D/route.ts"
click node_collection_api "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/route.ts"
click node_duplicate_api "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/%5BworkflowId%5D/duplicate/route.ts"
click node_run_api "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/run-workflow/route.ts"
click node_status_api "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflow-status/route.ts"
click node_trigger_task "https://github.com/shekhar143542/next_flow/blob/main/src/trigger/example.ts"
click node_node_execution "https://github.com/shekhar143542/next_flow/blob/main/src/trigger/example.ts"
click node_prisma "https://github.com/shekhar143542/next_flow/blob/main/src/lib/prisma.ts"
click node_run_records "https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflow-status/route.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_editor,node_node_editor,node_node_views,node_workflow_store,node_auto_save,node_load_workflow,node_workflow_api_client,node_workflow_list,node_workflow_cards,node_user toneBlue
class node_crud_api,node_collection_api,node_duplicate_api,node_run_api,node_status_api toneAmber
class node_trigger_task,node_node_execution toneMint
class node_prisma,node_postgres,node_run_records toneRose
class node_gemini,node_clerk toneIndigo
```

## Components

### Workflow authoring

- [Workflow editor](https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/workflow/workflowEditor.tsx): `src/app/(pages)/workflow/workflowEditor.tsx`
- [Node editor](https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/editor/NodeEditor.tsx): `src/app/(pages)/editor/NodeEditor.tsx`
- [Node views](https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/workflow/components/nodes.tsx): `src/app/(pages)/workflow/components/nodes.tsx`
- [Workflow state](https://github.com/shekhar143542/next_flow/blob/main/src/store/useWorkflowStore.ts): `src/store/useWorkflowStore.ts`
- [Autosave](https://github.com/shekhar143542/next_flow/blob/main/src/hooks/useAutoSaveWorkflow.ts): `src/hooks/useAutoSaveWorkflow.ts`
- [Workflow loading](https://github.com/shekhar143542/next_flow/blob/main/src/hooks/useLoadWorkflow.ts): `src/hooks/useLoadWorkflow.ts`
- [Workflow API client](https://github.com/shekhar143542/next_flow/blob/main/src/lib/workflowApi.ts): `src/lib/workflowApi.ts`
- [Workflow listing](https://github.com/shekhar143542/next_flow/blob/main/src/app/(pages)/editor/page.tsx): `src/app/(pages)/editor/page.tsx`
- [Workflow cards](https://github.com/shekhar143542/next_flow/blob/main/src/components/WorkflowCard.tsx): `src/components/WorkflowCard.tsx`

### Application APIs

- [Workflow CRUD](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/%5BworkflowId%5D/route.ts): `src/app/api/workflows/[workflowId]/route.ts`
- [Workflow collection](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/route.ts): `src/app/api/workflows/route.ts`
- [Workflow duplication](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflows/%5BworkflowId%5D/duplicate/route.ts): `src/app/api/workflows/[workflowId]/duplicate/route.ts`
- [Run request](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/run-workflow/route.ts): `src/app/api/run-workflow/route.ts`
- [Run status](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflow-status/route.ts): `src/app/api/workflow-status/route.ts`

### Workflow execution

- [Trigger task](https://github.com/shekhar143542/next_flow/blob/main/src/trigger/example.ts): `src/trigger/example.ts`
- [Node execution](https://github.com/shekhar143542/next_flow/blob/main/src/trigger/example.ts): `src/trigger/example.ts`

### Persistence

- [Prisma client](https://github.com/shekhar143542/next_flow/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **PostgreSQL**
- [Run records](https://github.com/shekhar143542/next_flow/blob/main/src/app/api/workflow-status/route.ts): `src/app/api/workflow-status/route.ts`

### Other components

- **User**
- **Gemini**
- **Clerk auth**

## Connections

- User → Workflow editor: edits workflow (evidence: `README.md`)
- Workflow editor → Workflow state: updates state
- Node editor → Workflow API client: creates workflow (evidence: `src/app/(pages)/editor/NodeEditor.tsx`)
- Workflow editor → Autosave: autosaves changes (evidence: `README.md`)
- Autosave → Workflow state: reads graph (evidence: `src/hooks/useAutoSaveWorkflow.ts`)
- Autosave → Workflow collection: creates workflow (evidence: `src/hooks/useAutoSaveWorkflow.ts`)
- Autosave → Workflow CRUD: saves graph (evidence: `src/hooks/useAutoSaveWorkflow.ts`)
- Workflow API client → Workflow collection: creates workflow (evidence: `src/lib/workflowApi.ts`)
- Workflow listing → Workflow cards: renders cards (evidence: `src/app/(pages)/editor/page.tsx`)
- Workflow listing → Workflow collection: lists workflows (evidence: `README.md`)
- Workflow cards → Workflow API client: renames or duplicates (evidence: `src/components/WorkflowCard.tsx`)
- Workflow API client → Workflow CRUD: updates or deletes (evidence: `src/lib/workflowApi.ts`)
- Workflow API client → Workflow duplication: duplicates workflow (evidence: `src/lib/workflowApi.ts`)
- Workflow editor → Workflow loading: loads workflow (evidence: `README.md`)
- Workflow loading → Workflow CRUD: fetches graph (evidence: `src/hooks/useLoadWorkflow.ts`)
- Workflow loading → Workflow state: loads graph (evidence: `src/hooks/useLoadWorkflow.ts`)
- User → Run request: starts run (evidence: `README.md`)
- Run request → Trigger task: starts task (evidence: `README.md`)
- Trigger task → Node execution: executes nodes (evidence: `src/trigger/example.ts`)
- Node execution → Gemini: generates content (evidence: `src/trigger/example.ts`)
- User → Run status: polls run (evidence: `README.md`)
- Run status → Trigger task: retrieves run (evidence: `src/app/api/workflow-status/route.ts`)
- Run status → Run records: persists completion (evidence: `src/app/api/workflow-status/route.ts`)
- Run records → Prisma client: upserts output (evidence: `src/app/api/workflow-status/route.ts`)
- Workflow collection → Prisma client: reads or creates (evidence: `src/app/api/workflows/route.ts`)
- Workflow CRUD → Prisma client: reads or writes (evidence: `src/app/api/workflows/[workflowId]/route.ts`)
- Workflow duplication → Prisma client: duplicates data (evidence: `src/app/api/workflows/[workflowId]/duplicate/route.ts`)
- Trigger task → Prisma client: loads workflow (evidence: `README.md`)
- Prisma client → PostgreSQL: queries database (evidence: `src/lib/prisma.ts`)
- Workflow collection → Clerk auth: authenticates user (evidence: `src/app/api/workflows/route.ts`)
- Workflow CRUD → Clerk auth: authenticates user (evidence: `src/app/api/workflows/[workflowId]/route.ts`)
- Run status → User: returns status (evidence: `README.md`)
- Node views → Workflow editor: renders nodes
