# 403errors/ideaflowai architecture

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

## Overview

IdeaFlowAI turns a user’s concept into a saved, developer-ready application plan through a guided creation flow: idea extraction, adaptive questionnaires, add-on and stack choices, plan synthesis, and setup-brief generation. Saved projects can be browsed, reopened for feature-prompt generation, and deleted. The source excerpts establish the creation orchestrator, project persistence, and authentication; README descriptions cover several AI capabilities whose detailed implementation was not sampled.

Main entry points: [`src/ai/genkit.ts`](https://github.com/403errors/ideaflowai/blob/main/src/ai/genkit.ts) (Genkit model setup), [`src/app/create/page.tsx`](https://github.com/403errors/ideaflowai/blob/main/src/app/create/page.tsx) (Guided creation), [`src/components/project-setup-display.tsx`](https://github.com/403errors/ideaflowai/blob/main/src/components/project-setup-display.tsx) (Development brief), [`src/lib/actions.ts`](https://github.com/403errors/ideaflowai/blob/main/src/lib/actions.ts) (Project operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Plan creation"]
  node_create["Guided creation<br/>[page.tsx]"]
  node_ideaform["Idea input<br/>[idea-form.tsx]"]
  node_questionnaire["Adaptive questions<br/>[mcq-form.tsx]"]
  node_addons["Optional add-ons<br/>[addons-form.tsx]"]
  node_stack["Stack selection"]
  node_summary["Plan summary"]
  node_setup["Development brief"]
end

subgraph group_ai["AI generation"]
  node_ideaextract["Idea extraction<br/>[extract-idea.ts]"]
  node_mcq["Question generation<br/>[generate-mcq.ts]"]
  node_stackrec["Stack recommendations"]
  node_finalsummary["Final plan synthesis"]
  node_projectname["Project naming"]
  node_setupgen["Setup generation"]
  node_features["Feature extraction"]
  node_featureprompt["Feature prompts"]
  node_codegen["Code generation<br/>[generate-code.ts]"]
  node_genkit["Genkit model setup<br/>[genkit.ts]"]
end

subgraph group_projects["Projects and identity"]
  node_dashboard["Project dashboard<br/>[page.tsx]"]
  node_projectview["Saved project view<br/>[page.tsx]"]
  node_actions["Project operations<br/>[actions.ts]"]
  node_auth["Authentication<br/>[auth-context.tsx]"]
end

subgraph group_platform["External services"]
  node_firestore[("Firestore")]
  node_firebaseauth["Firebase Authentication"]
  node_gemini["Google Gemini"]
end

node_user(("Project creator"))

node_user -->|"submits idea"| node_create
node_create -->|"renders"| node_ideaform
node_ideaform -->|"extracts idea"| node_ideaextract
node_create -->|"renders"| node_questionnaire
node_questionnaire -->|"requests questions"| node_mcq
node_create -->|"renders"| node_addons
node_create -->|"renders"| node_stack
node_stack -.->|"requests suggestions"| node_stackrec
node_create -->|"renders"| node_summary
node_summary -->|"generates plan"| node_finalsummary
node_summary -->|"generates name"| node_projectname
node_create -->|"renders"| node_setup
node_setup -->|"generates setup"| node_setupgen
node_setup -->|"extracts features"| node_features
node_setup -->|"saves project"| node_actions
node_dashboard -->|"loads and deletes"| node_actions
node_projectview -->|"loads project"| node_actions
node_projectview -->|"extracts features"| node_features
node_projectview -.->|"generates prompts"| node_featureprompt
node_actions -->|"reads and writes"| node_firestore
node_auth -->|"authenticates users"| node_firebaseauth
node_auth -->|"stores user profile"| node_firestore
node_ideaextract -->|"uses runtime"| node_genkit
node_mcq -->|"uses runtime"| node_genkit
node_finalsummary -->|"uses runtime"| node_genkit
node_setupgen -->|"uses runtime"| node_genkit
node_features -->|"uses runtime"| node_genkit
node_featureprompt -->|"uses runtime"| node_genkit
node_projectname -->|"uses runtime"| node_genkit
node_genkit -->|"calls model"| node_gemini
node_stackrec -.->|"uses runtime"| node_genkit
node_codegen -.->|"uses runtime"| node_genkit

click node_create "https://github.com/403errors/ideaflowai/blob/main/src/app/create/page.tsx"
click node_ideaform "https://github.com/403errors/ideaflowai/blob/main/src/components/idea-form.tsx"
click node_questionnaire "https://github.com/403errors/ideaflowai/blob/main/src/components/mcq-form.tsx"
click node_addons "https://github.com/403errors/ideaflowai/blob/main/src/components/addons-form.tsx"
click node_stack "https://github.com/403errors/ideaflowai/blob/main/src/components/tech-stack-form.tsx"
click node_summary "https://github.com/403errors/ideaflowai/blob/main/src/components/summary-display.tsx"
click node_setup "https://github.com/403errors/ideaflowai/blob/main/src/components/project-setup-display.tsx"
click node_ideaextract "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/extract-idea.ts"
click node_mcq "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-mcq.ts"
click node_stackrec "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/recommend-tech-stack.ts"
click node_finalsummary "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-final-summary.ts"
click node_projectname "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-project-name.ts"
click node_setupgen "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-project-setup.ts"
click node_features "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/extract-features.ts"
click node_featureprompt "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-feature-prompt.ts"
click node_codegen "https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-code.ts"
click node_genkit "https://github.com/403errors/ideaflowai/blob/main/src/ai/genkit.ts"
click node_dashboard "https://github.com/403errors/ideaflowai/blob/main/src/app/dashboard/page.tsx"
click node_projectview "https://github.com/403errors/ideaflowai/blob/main/src/app/project/%5Bid%5D/page.tsx"
click node_actions "https://github.com/403errors/ideaflowai/blob/main/src/lib/actions.ts"
click node_auth "https://github.com/403errors/ideaflowai/blob/main/src/contexts/auth-context.tsx"

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_create,node_ideaform,node_questionnaire,node_addons,node_stack,node_summary,node_setup toneBlue
class node_ideaextract,node_mcq,node_stackrec,node_finalsummary,node_projectname,node_setupgen,node_features,node_featureprompt,node_codegen,node_genkit toneAmber
class node_dashboard,node_projectview,node_actions,node_auth toneMint
class node_firestore,node_firebaseauth,node_gemini toneRose
class node_user toneIndigo
```

## Components

### Plan creation

- [Guided creation](https://github.com/403errors/ideaflowai/blob/main/src/app/create/page.tsx): `src/app/create/page.tsx`
- [Idea input](https://github.com/403errors/ideaflowai/blob/main/src/components/idea-form.tsx): `src/components/idea-form.tsx`
- [Adaptive questions](https://github.com/403errors/ideaflowai/blob/main/src/components/mcq-form.tsx): `src/components/mcq-form.tsx`
- [Optional add-ons](https://github.com/403errors/ideaflowai/blob/main/src/components/addons-form.tsx): `src/components/addons-form.tsx`
- [Stack selection](https://github.com/403errors/ideaflowai/blob/main/src/components/tech-stack-form.tsx): `src/components/tech-stack-form.tsx`
- [Plan summary](https://github.com/403errors/ideaflowai/blob/main/src/components/summary-display.tsx): `src/components/summary-display.tsx`
- [Development brief](https://github.com/403errors/ideaflowai/blob/main/src/components/project-setup-display.tsx): `src/components/project-setup-display.tsx`

### AI generation

- [Idea extraction](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/extract-idea.ts): `src/ai/flows/extract-idea.ts`
- [Question generation](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-mcq.ts): `src/ai/flows/generate-mcq.ts`
- [Stack recommendations](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/recommend-tech-stack.ts): `src/ai/flows/recommend-tech-stack.ts`
- [Final plan synthesis](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-final-summary.ts): `src/ai/flows/generate-final-summary.ts`
- [Project naming](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-project-name.ts): `src/ai/flows/generate-project-name.ts`
- [Setup generation](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-project-setup.ts): `src/ai/flows/generate-project-setup.ts`
- [Feature extraction](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/extract-features.ts): `src/ai/flows/extract-features.ts`
- [Feature prompts](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-feature-prompt.ts): `src/ai/flows/generate-feature-prompt.ts`
- [Code generation](https://github.com/403errors/ideaflowai/blob/main/src/ai/flows/generate-code.ts): `src/ai/flows/generate-code.ts`
- [Genkit model setup](https://github.com/403errors/ideaflowai/blob/main/src/ai/genkit.ts): `src/ai/genkit.ts`

### Projects and identity

- [Project dashboard](https://github.com/403errors/ideaflowai/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Saved project view](https://github.com/403errors/ideaflowai/blob/main/src/app/project/%5Bid%5D/page.tsx): `src/app/project/[id]/page.tsx`
- [Project operations](https://github.com/403errors/ideaflowai/blob/main/src/lib/actions.ts): `src/lib/actions.ts`
- [Authentication](https://github.com/403errors/ideaflowai/blob/main/src/contexts/auth-context.tsx): `src/contexts/auth-context.tsx`

### External services

- **Firestore**
- **Firebase Authentication**
- **Google Gemini**

### Other components

- **Project creator**

## Connections

- Project creator → Guided creation: submits idea
- Guided creation → Idea input: renders (evidence: `src/app/create/page.tsx`)
- Idea input → Idea extraction: extracts idea (evidence: `src/components/idea-form.tsx`)
- Guided creation → Adaptive questions: renders (evidence: `src/app/create/page.tsx`)
- Adaptive questions → Question generation: requests questions (evidence: `src/components/mcq-form.tsx`)
- Guided creation → Optional add-ons: renders (evidence: `src/app/create/page.tsx`)
- Guided creation → Stack selection: renders (evidence: `src/app/create/page.tsx`)
- Stack selection → Stack recommendations: requests suggestions
- Guided creation → Plan summary: renders (evidence: `src/app/create/page.tsx`)
- Plan summary → Final plan synthesis: generates plan (evidence: `src/components/summary-display.tsx`)
- Plan summary → Project naming: generates name (evidence: `src/components/summary-display.tsx`)
- Guided creation → Development brief: renders (evidence: `src/app/create/page.tsx`)
- Development brief → Setup generation: generates setup (evidence: `src/components/project-setup-display.tsx`)
- Development brief → Feature extraction: extracts features (evidence: `src/components/project-setup-display.tsx`)
- Development brief → Project operations: saves project (evidence: `src/components/project-setup-display.tsx`)
- Project dashboard → Project operations: loads and deletes (evidence: `src/app/dashboard/page.tsx`)
- Saved project view → Project operations: loads project (evidence: `src/app/project/[id]/page.tsx`)
- Saved project view → Feature extraction: extracts features (evidence: `src/app/project/[id]/page.tsx`)
- Saved project view → Feature prompts: generates prompts
- Project operations → Firestore: reads and writes (evidence: `src/lib/actions.ts`)
- Authentication → Firebase Authentication: authenticates users (evidence: `src/contexts/auth-context.tsx`)
- Authentication → Firestore: stores user profile (evidence: `src/contexts/auth-context.tsx`)
- Idea extraction → Genkit model setup: uses runtime (evidence: `src/ai/flows/extract-idea.ts`)
- Question generation → Genkit model setup: uses runtime (evidence: `src/ai/flows/generate-mcq.ts`)
- Final plan synthesis → Genkit model setup: uses runtime (evidence: `src/ai/flows/generate-final-summary.ts`)
- Setup generation → Genkit model setup: uses runtime (evidence: `src/ai/flows/generate-project-setup.ts`)
- Feature extraction → Genkit model setup: uses runtime (evidence: `src/ai/flows/extract-features.ts`)
- Feature prompts → Genkit model setup: uses runtime (evidence: `src/ai/flows/generate-feature-prompt.ts`)
- Project naming → Genkit model setup: uses runtime (evidence: `src/ai/flows/generate-project-name.ts`)
- Genkit model setup → Google Gemini: calls model (evidence: `src/ai/genkit.ts`)
- Stack recommendations → Genkit model setup: uses runtime
- Code generation → Genkit model setup: uses runtime
