How talmastera/hackathon works
FitIn is a bilingual, browser-based furniture-layout editor. Users select a built-in plan or trace their own, edit furniture in a shared 2D/3D workspace, and inspect fit issues; optional tools provide rule-based layout proposals and AI-generated furniture appearance. Geometry, measurements, and checks run locally. The graph preserves the documented workflows and major capabilities; several feature links are documented in the README but their implementation was not sampled, so those links cite the README rather than implying source inspection.
Main entry points: workspace.tsx Editor workspace · review-step.tsx Trace review · assistant-panel.tsx Assistant panel · look-panel.tsx Look controls
Components 25
Layout workspace
- Editor workspace
src/features/flat-editor/workspace.tsx - Plan presets
src/data/flat-preset.ts - Layout state
src/features/flat-editor/state.ts - 2D floor plan
src/components/plan/floor-plan.tsx - 3D room scene
src/components/scene/room-scene.tsx - Furniture models
src/components/scene/furniture-mesh.tsx - Plan source panel
src/components/source-panel.tsx
Plan tracing
- Trace review
src/features/floor-trace/review-step.tsx - Trace workflow
src/features/floor-trace/trace-state.ts - Plan reader client
src/features/floor-trace/floorplan-client.ts - Plan reading API
src/app/api/floorplan/route.ts - Trace model
src/lib/floorplan/trace.ts
Geometry and checks
- Flat architecture
src/lib/geometry/architecture.ts - Layout checks
src/lib/geometry/layout.ts - Oriented footprints
src/lib/geometry/oriented.ts - Polygon operations
src/lib/geometry/polygon.ts
Design assistant
- Assistant panel
src/features/design-assistant/assistant-panel.tsx - Room context
src/features/design-assistant/context.ts - Proposal session
src/features/design-assistant/session.ts
3D looks
- Look controls
src/features/model-looks/look-panel.tsx - Look state
src/features/model-looks/looks.ts - Model generation client
src/features/model-looks/model3d-client.ts - 3D model API
src/app/api/model3d/route.ts - fal.ai generation
src/lib/model3d/fal-server.ts
Other components
- Household user
Connections 28
- Household user → Editor workspace: edits layout
- Editor workspace → Plan presets: selects plan
src/features/flat-editor/workspace.tsx - Editor workspace → Layout state: updates state
src/features/flat-editor/workspace.tsx - Editor workspace → 2D floor plan: renders plan
src/features/flat-editor/workspace.tsx - Editor workspace → 3D room scene: renders scene
src/features/flat-editor/workspace.tsx - Editor workspace → Plan source panel: shows source
src/features/flat-editor/workspace.tsx - 2D floor plan → Flat architecture: draws architecture
src/components/plan/floor-plan.tsx - 3D room scene → Furniture models: renders furniture
src/components/scene/room-scene.tsx - Household user → Trace review: traces flat
- Trace review → Trace model: edits trace
src/features/floor-trace/review-step.tsx - Trace review → Trace workflow: uses workflow
src/features/floor-trace/review-step.tsx - Trace workflow → Plan reader client: requests reading
- Plan reader client → Plan reading API: posts plan
- Plan reading API → Trace model: validates type
src/app/api/floorplan/route.ts - Trace model → Polygon operations: simplifies polygons
src/lib/floorplan/trace.ts - Flat architecture → Oriented footprints: uses footprints
src/lib/geometry/architecture.ts - Polygon operations → Oriented footprints: uses polygon helpers
src/lib/geometry/polygon.ts - Layout state → Layout checks: checks fit
- Household user → Assistant panel: requests proposal
- Assistant panel → Room context: builds context
src/features/design-assistant/context.ts - Assistant panel → Proposal session: manages proposal
- Proposal session → Layout state: applies accepted moves
src/features/design-assistant/session.ts - Household user → Look controls: requests appearance
- Look controls → Look state: manages looks
- Look state → Furniture models: supplies appearance
src/components/scene/furniture-mesh.tsx - Look controls → Model generation client: starts generation
- Model generation client → 3D model API: posts photo
- 3D model API → fal.ai generation: requests generation
src/app/api/model3d/route.ts