# joshsdesk/fix-it-build-it architecture

> Architecture diagram of the GitHub repository joshsdesk/fix-it-build-it, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joshsdesk/fix-it-build-it
- Repository: https://github.com/joshsdesk/fix-it-build-it

## Overview

FIX IT, BUILD IT COLORADO is a services and information site for specialized home adaptations, with a sensory-needs assessment that can prefill a consultation request. Visitors also use a contact form, funding and policy pages, and a digital business card; administrators have login, setup, search, and settings areas. The graph follows the evidenced home-page and vCard composition. Contact submission, administrative API wiring, payments, and booking are represented only where strongly implied, with unverified links dashed; their implementations were not sampled.

Main entry points: [`app/page.tsx`](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/page.tsx) (Home page), [`features/sensory-wizard/SensoryWizard.tsx`](https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/SensoryWizard.tsx) (Needs wizard), [`functions/api/admin`](https://github.com/joshsdesk/fix-it-build-it/tree/main/functions/api/admin) (Admin endpoints), [`app/vcard/page.tsx`](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/vcard/page.tsx) (Business card page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_home["Home page<br/>[page.tsx]"]
  node_site_sections["Site sections"]
  node_services_page["Services information<br/>[page.tsx]"]
  node_funding_page["Funding information<br/>[page.tsx]"]
  node_policy_pages["Policies and packages"]
end

subgraph group_assessment["Assessment and contact"]
  node_sensory_wizard["Needs wizard<br/>[SensoryWizard.tsx]"]
  node_wizard_reducer["Wizard state<br/>[WizardReducer.ts]"]
  node_wizard_steps["Wizard steps"]
  node_step_behavior["Behavior step<br/>[Step2Behavior.tsx]"]
  node_step_recommendations["Recommendations step"]
  node_contact_modal["Contact form<br/>[ContactModal.tsx]"]
end

subgraph group_vcard["Digital business card"]
  node_vcard_page["Business card page<br/>[page.tsx]"]
  node_vcard_cards["Profile and links"]
  node_business_data["Business profile data<br/>[BusinessInfo.tsx]"]
end

subgraph group_admin["Administration"]
  node_admin_login["Admin login<br/>[page.tsx]"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_search["Lead search<br/>[page.tsx]"]
  node_admin_settings["Admin settings<br/>[page.tsx]"]
  node_admin_setup["Admin setup<br/>[page.tsx]"]
end

subgraph group_backend["API and services"]
  node_contact_api["Contact endpoint<br/>[contact.ts]"]
  node_admin_api["Admin endpoints"]
  node_booking_api["Booking confirmation<br/>[confirm-booking.ts]"]
  node_checkout_api["Checkout endpoint<br/>[checkout.ts]"]
  node_schema[("Data schema<br/>[schema.ts]")]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_site_sections
node_home -->|"renders"| node_sensory_wizard
node_home -->|"opens"| node_contact_modal
node_sensory_wizard -->|"dispatches state"| node_wizard_reducer
node_sensory_wizard -->|"renders steps"| node_wizard_steps
node_sensory_wizard -->|"renders"| node_step_behavior
node_sensory_wizard -->|"renders"| node_step_recommendations
node_step_recommendations -->|"requests consultation"| node_contact_modal
node_contact_modal -.->|"submits form"| node_contact_api
node_home -.->|"links to"| node_services_page
node_visitor -.->|"visits"| node_funding_page
node_visitor -.->|"visits"| node_policy_pages
node_visitor -.->|"visits"| node_vcard_page
node_vcard_page -->|"renders"| node_vcard_cards
node_vcard_page -->|"opens"| node_contact_modal
node_vcard_page -->|"reads profile"| node_business_data
node_visitor -.->|"visits"| node_admin_login
node_admin_login -.->|"authenticates"| node_admin_api
node_admin_dashboard -.->|"uses admin endpoints"| node_admin_api
node_admin_search -.->|"searches records"| node_admin_api
node_admin_settings -.->|"updates settings"| node_admin_api
node_admin_setup -.->|"initializes access"| node_admin_api
node_contact_api -.->|"persists data"| node_schema
node_booking_api -.->|"persists booking"| node_schema
node_checkout_api -.->|"uses data"| node_schema

click node_home "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/page.tsx"
click node_site_sections "https://github.com/joshsdesk/fix-it-build-it/tree/main/components/layout"
click node_services_page "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/services/page.tsx"
click node_funding_page "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/funding/page.tsx"
click node_policy_pages "https://github.com/joshsdesk/fix-it-build-it/tree/main/app"
click node_sensory_wizard "https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/SensoryWizard.tsx"
click node_wizard_reducer "https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/WizardReducer.ts"
click node_wizard_steps "https://github.com/joshsdesk/fix-it-build-it/tree/main/features/sensory-wizard/steps"
click node_step_behavior "https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/steps/Step2Behavior.tsx"
click node_step_recommendations "https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/steps/Step6Recommendations.tsx"
click node_contact_modal "https://github.com/joshsdesk/fix-it-build-it/blob/main/components/ContactModal.tsx"
click node_contact_api "https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/contact.ts"
click node_vcard_page "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/vcard/page.tsx"
click node_vcard_cards "https://github.com/joshsdesk/fix-it-build-it/tree/main/components/vcard"
click node_business_data "https://github.com/joshsdesk/fix-it-build-it/blob/main/config/BusinessInfo.tsx"
click node_admin_login "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/login/page.tsx"
click node_admin_dashboard "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/page.tsx"
click node_admin_search "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/search/page.tsx"
click node_admin_settings "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/settings/page.tsx"
click node_admin_setup "https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/setup/page.tsx"
click node_admin_api "https://github.com/joshsdesk/fix-it-build-it/tree/main/functions/api/admin"
click node_booking_api "https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/confirm-booking.ts"
click node_checkout_api "https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/checkout.ts"
click node_schema "https://github.com/joshsdesk/fix-it-build-it/blob/main/db/schema.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_home,node_site_sections,node_services_page,node_funding_page,node_policy_pages toneBlue
class node_sensory_wizard,node_wizard_reducer,node_wizard_steps,node_step_behavior,node_step_recommendations,node_contact_modal toneAmber
class node_vcard_page,node_vcard_cards,node_business_data toneMint
class node_admin_login,node_admin_dashboard,node_admin_search,node_admin_settings,node_admin_setup toneRose
class node_contact_api,node_admin_api,node_booking_api,node_checkout_api,node_schema,node_visitor toneIndigo
```

## Components

### Public site

- [Home page](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/page.tsx): `app/page.tsx`
- [Site sections](https://github.com/joshsdesk/fix-it-build-it/tree/main/components/layout): `components/layout`
- [Services information](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/services/page.tsx): `app/services/page.tsx`
- [Funding information](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/funding/page.tsx): `app/funding/page.tsx`
- [Policies and packages](https://github.com/joshsdesk/fix-it-build-it/tree/main/app): `app`

### Assessment and contact

- [Needs wizard](https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/SensoryWizard.tsx): `features/sensory-wizard/SensoryWizard.tsx`
- [Wizard state](https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/WizardReducer.ts): `features/sensory-wizard/WizardReducer.ts`
- [Wizard steps](https://github.com/joshsdesk/fix-it-build-it/tree/main/features/sensory-wizard/steps): `features/sensory-wizard/steps`
- [Behavior step](https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/steps/Step2Behavior.tsx): `features/sensory-wizard/steps/Step2Behavior.tsx`
- [Recommendations step](https://github.com/joshsdesk/fix-it-build-it/blob/main/features/sensory-wizard/steps/Step6Recommendations.tsx): `features/sensory-wizard/steps/Step6Recommendations.tsx`
- [Contact form](https://github.com/joshsdesk/fix-it-build-it/blob/main/components/ContactModal.tsx): `components/ContactModal.tsx`

### Digital business card

- [Business card page](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/vcard/page.tsx): `app/vcard/page.tsx`
- [Profile and links](https://github.com/joshsdesk/fix-it-build-it/tree/main/components/vcard): `components/vcard`
- [Business profile data](https://github.com/joshsdesk/fix-it-build-it/blob/main/config/BusinessInfo.tsx): `config/BusinessInfo.tsx`

### Administration

- [Admin login](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/login/page.tsx): `app/admin/login/page.tsx`
- [Admin dashboard](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Lead search](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/search/page.tsx): `app/admin/search/page.tsx`
- [Admin settings](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/settings/page.tsx): `app/admin/settings/page.tsx`
- [Admin setup](https://github.com/joshsdesk/fix-it-build-it/blob/main/app/admin/setup/page.tsx): `app/admin/setup/page.tsx`

### API and services

- [Contact endpoint](https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/contact.ts): `functions/api/contact.ts`
- [Admin endpoints](https://github.com/joshsdesk/fix-it-build-it/tree/main/functions/api/admin): `functions/api/admin`
- [Booking confirmation](https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/confirm-booking.ts): `functions/api/confirm-booking.ts`
- [Checkout endpoint](https://github.com/joshsdesk/fix-it-build-it/blob/main/functions/api/checkout.ts): `functions/api/checkout.ts`
- [Data schema](https://github.com/joshsdesk/fix-it-build-it/blob/main/db/schema.ts): `db/schema.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: visits (evidence: `app/page.tsx`)
- Home page → Site sections: renders (evidence: `app/page.tsx`)
- Home page → Needs wizard: renders (evidence: `app/page.tsx`)
- Home page → Contact form: opens (evidence: `app/page.tsx`)
- Needs wizard → Wizard state: dispatches state (evidence: `features/sensory-wizard/SensoryWizard.tsx`)
- Needs wizard → Wizard steps: renders steps (evidence: `features/sensory-wizard/SensoryWizard.tsx`)
- Needs wizard → Behavior step: renders (evidence: `features/sensory-wizard/SensoryWizard.tsx`)
- Needs wizard → Recommendations step: renders (evidence: `features/sensory-wizard/SensoryWizard.tsx`)
- Recommendations step → Contact form: requests consultation
- Contact form → Contact endpoint: submits form
- Home page → Services information: links to
- Visitor → Funding information: visits
- Visitor → Policies and packages: visits
- Visitor → Business card page: visits
- Business card page → Profile and links: renders (evidence: `app/vcard/page.tsx`)
- Business card page → Contact form: opens (evidence: `app/vcard/page.tsx`)
- Business card page → Business profile data: reads profile (evidence: `app/vcard/page.tsx`)
- Visitor → Admin login: visits
- Admin login → Admin endpoints: authenticates
- Admin dashboard → Admin endpoints: uses admin endpoints
- Lead search → Admin endpoints: searches records
- Admin settings → Admin endpoints: updates settings
- Admin setup → Admin endpoints: initializes access
- Contact endpoint → Data schema: persists data
- Booking confirmation → Data schema: persists booking
- Checkout endpoint → Data schema: uses data
