How vivekmaury/ighouse works
IgHouse is an Instagram automation platform: users build and manage workflow canvases, while Instagram events trigger matching workflows that send replies or direct messages. The graph also shows webhook verification and retry processing, workflow persistence and execution logging, and the dashboard/inbox surface. Source evidence is sampled and incomplete; documented capabilities are retained, but uncertain wiring—particularly the separate Supabase Edge Functions—is not inferred.
Main entry points: page.tsx Flow editor · workflow-engine.ts Workflow engine · route.ts Webhook endpoint · webhook-processor.ts Queue processor
Components 25
Workflow authoring
- Flow editor
src/app/dashboard/flows/new/page.tsx - Flow actions
src/app/actions/flow-actions.ts - Node palette
src/components/flows/FlowSidebar.tsx - Custom nodes
src/components/flows/CustomNodes.tsx - Trigger node
src/components/canvas/nodes/TriggerNode.tsx - Message node
src/components/canvas/nodes/MessageNode.tsx - Condition node
src/components/canvas/nodes/ConditionNode.tsx - Delay node
src/components/canvas/nodes/DelayNode.tsx - Flow management
src/app/dashboard/flows/page.tsx - Flow detail
src/app/dashboard/flows/[id]/page.tsx
Instagram automation
- Webhook endpoint
src/app/api/webhooks/instagram/route.ts - Workflow engine
src/lib/workflow-engine.ts - Queue processor
src/lib/queue/webhook-processor.ts - Retry trigger
src/app/api/cron/process-webhooks/route.ts - Instagram messaging
src/lib/meta/graph-api.ts
Accounts and state
- Webhook queue
src/lib/queue/upstash.ts - Admin client
src/lib/supabase/admin.ts - Supabase data
supabase/migrations/20261004000000_init_schema.sql - Server auth client
src/utils/supabase/server.ts
User experience
- Dashboard
src/app/dashboard/page.tsx - Inbox
src/app/dashboard/inbox/page.tsx - Sign-in pages
src/app/login/page.tsx - Signup
src/app/signup/page.tsx
Other components
- Workspace user
- Instagram platform
Connections 29
- Workspace user → Flow editor: builds flows
src/app/dashboard/flows/new/page.tsx - Flow editor → Node palette: uses palette
src/app/dashboard/flows/new/page.tsx - Flow editor → Custom nodes: renders nodes
src/app/dashboard/flows/new/page.tsx - Flow editor → Trigger node: uses node
- Flow editor → Message node: uses node
- Flow editor → Condition node: uses node
- Flow editor → Delay node: uses node
- Flow editor → Flow actions: saves flows
src/app/dashboard/flows/new/page.tsx - Flow management → Flow actions: loads flows
src/app/dashboard/flows/page.tsx - Flow detail → Node palette: renders palette
src/app/dashboard/flows/[id]/page.tsx - Flow detail → Custom nodes: renders nodes
src/app/dashboard/flows/[id]/page.tsx - Flow actions → Server auth client: creates client
src/app/actions/flow-actions.ts - Server auth client → Supabase data: accesses data
src/utils/supabase/server.ts - Instagram platform → Webhook endpoint: sends events
README.md - Webhook endpoint → Workflow engine: evaluates event
src/app/api/webhooks/instagram/route.ts - Webhook endpoint → Webhook queue: queues failures
src/app/api/webhooks/instagram/route.ts - Webhook endpoint → Admin client: logs event
src/app/api/webhooks/instagram/route.ts - Retry trigger → Queue processor: starts batch
src/app/api/cron/process-webhooks/route.ts - Queue processor → Webhook queue: dequeues retries
src/lib/queue/webhook-processor.ts - Queue processor → Workflow engine: processes payload
src/lib/queue/webhook-processor.ts - Workflow engine → Admin client: creates client
src/lib/workflow-engine.ts - Workflow engine → Webhook queue: rate limits
src/lib/workflow-engine.ts - Workflow engine → Instagram messaging: sends responses
src/lib/workflow-engine.ts - Workflow engine → Supabase data: reads workflows
src/lib/workflow-engine.ts - Workflow engine → Supabase data: writes execution logs
src/lib/workflow-engine.ts - Workspace user → Sign-in pages: signs in
- Workspace user → Signup: creates account
src/app/signup/page.tsx - Workspace user → Dashboard: views workspace
- Workspace user → Inbox: views messages