How naveen-2006-stack/archadaptai works
ArchAdapt AI is a web-based architectural design tool. Users provide site, household, and style requirements during onboarding; the generation API turns those inputs into a validated floor plan, which users inspect in 2D and 3D, adjust through What-If requests, compare as versions, and save to Supabase. The generation engine combines a rule-based local planner with optional Gemini-generated programs, then lays out and validates plans. The README also documents regional knowledge retrieval and appearance controls; their detailed runtime wiring is not shown in the sampled excerpts, so those links are omitted.
Main entry points: pipeline.ts Generation pipeline · [id]/page.tsx Design workspace · route.ts What-If API · onboarding/page.tsx Design brief
Components 27
User experience
- Design brief
src/app/onboarding/page.tsx - Generate API
src/app/api/design/generate/route.ts - What-If API
src/app/api/design/what-if/route.ts - Design workspace
src/app/workspace/[id]/page.tsx - Version comparison
src/components/workspace/VersionComparisonModal.tsx
Design generation
- Generation pipeline
src/lib/design/pipeline.ts - Rule-based planner
src/lib/genai/localPlanner.ts - Gemini generation
src/lib/genai/gemini.ts - Program prompts
src/lib/genai/prompts.ts - Regional knowledge
src/lib/genai/rag/architecturalKnowledge.ts - Program parsing
src/lib/design/program.ts - Spatial layout
src/lib/design/layoutEngine.ts - Doors and windows
src/lib/design/openings.ts - Plan validation
src/lib/design/validateFloorPlan.ts - What-If engine
src/lib/design/whatIf.ts - Concept diversity
src/lib/design/conceptDiversity.ts
Plan visualization
- 2D floor plan
src/components/canvas/FloorPlan2DRenderer.tsx - 3D house viewer
src/components/canvas/Massing3DViewer.tsx - House geometry
src/lib/geometry/buildHouseGeometry.ts - Plan geometry
src/lib/geometry/planGeometry.ts - Appearance controls
src/components/workspace/AppearancePanel.tsx
Projects and storage
- Project service
src/lib/services/projectService.ts - Supabase
Identity
- Authentication UI
src/components/auth/AuthModal.tsx - Supabase auth client
src/lib/supabase/client.ts
Other components
- Designer
- Gemini service
Connections 29
- Designer → Design brief: enters brief
src/app/onboarding/page.tsx - Design brief → Generate API: requests generation
src/app/api/design/generate/route.ts - Generate API → Generation pipeline: generates design
src/app/api/design/generate/route.ts - Generation pipeline → Rule-based planner: builds baseline
src/lib/design/pipeline.ts - Generation pipeline → Program prompts: builds prompts
src/lib/design/pipeline.ts - Generation pipeline → Gemini generation: requests program
src/lib/design/pipeline.ts - Gemini generation → Gemini service: calls model
- Generation pipeline → Program parsing: parses program
src/lib/design/pipeline.ts - Generation pipeline → Spatial layout: lays out plan
src/lib/design/pipeline.ts - Generation pipeline → Plan validation: validates plan
src/lib/design/pipeline.ts - Spatial layout → Doors and windows: solves openings
src/lib/design/layoutEngine.ts - Spatial layout → Plan geometry: uses geometry
src/lib/design/layoutEngine.ts - Design workspace → 2D floor plan: renders plan
src/app/workspace/[id]/page.tsx - Design workspace → 3D house viewer: renders house
src/app/workspace/[id]/page.tsx - 3D house viewer → House geometry: builds model
src/components/canvas/Massing3DViewer.tsx - 3D house viewer → Appearance controls: uses controls
src/components/canvas/Massing3DViewer.tsx - Design workspace → Plan validation: checks edits
src/app/workspace/[id]/page.tsx - Designer → What-If API: requests change
src/app/api/design/what-if/route.ts - What-If API → What-If engine: runs change
src/app/api/design/what-if/route.ts - What-If API → Generation pipeline: generates alternative
src/app/api/design/what-if/route.ts - What-If API → Concept diversity: checks diversity
src/app/api/design/what-if/route.ts - Design workspace → Version comparison: opens comparison
src/app/workspace/[id]/page.tsx - Design brief → Project service: creates project
src/app/onboarding/page.tsx - Design workspace → Project service: loads project
src/app/workspace/[id]/page.tsx - Project service → Supabase: reads and writes
src/lib/services/projectService.ts - Designer → Authentication UI: signs in
src/components/auth/AuthModal.tsx - Authentication UI → Supabase auth client: authenticates
src/components/auth/AuthModal.tsx - Supabase auth client → Supabase: uses client
src/lib/supabase/client.ts - Generation pipeline → Regional knowledge: retrieves knowledge
src/lib/design/pipeline.ts