# alihasnain-se/design-build-hub architecture

> Architecture diagram of the GitHub repository alihasnain-se/design-build-hub, 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/alihasnain-se/design-build-hub
- Repository: https://github.com/alihasnain-se/design-build-hub

## Overview

Design & Build Hub is a cross-platform marketplace connecting clients with interior designers, engineers, and architects, with a separately launched web admin panel. The main user journey is account access → professional discovery and profile review → hire request or consultation → chat and project management, with reviews and notifications supporting the engagement. The Flutter feature directories represent the client and creator domains; Firebase and Supabase provide backend services, while Cloud Functions implement server-side validation, media handling, hire-request operations, and review analytics. The README documents capabilities not visible in sampled Dart source; those links are cited to the README.

Main entry points: [`lib/main.dart`](https://github.com/alihasnain-se/design-build-hub/blob/main/lib/main.dart) (App entry), [`lib/features/hire_requests`](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/hire_requests) (Hire requests), [`lib/features/designer_profile`](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/designer_profile) (Professional profiles), [`functions/src/index.ts`](https://github.com/alihasnain-se/design-build-hub/blob/main/functions/src/index.ts) (Cloud Functions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter App"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_authentication["Authentication"]
end

subgraph group_marketplace["Marketplace"]
  node_discovery["Professional discovery"]
  node_profiles["Professional profiles"]
  node_services["Services and pricing"]
  node_posts["Portfolio posts"]
end

subgraph group_engagement["Project Engagement"]
  node_hire["Hire requests"]
  node_chat["In-app chat"]
  node_reviews["Reviews"]
  node_notifications["Notifications"]
  node_reports["User reports"]
end

subgraph group_backend["Backend Services"]
  node_cloud_functions["Cloud Functions<br/>[index.ts]"]
  node_validators["Request validators<br/>[validators.ts]"]
  node_firebase[("Firebase services")]
  node_supabase_storage["Supabase storage"]
end

subgraph group_administration["Administration"]
  node_admin_entry["Admin entry<br/>[admin_main.dart]"]
  node_admin_panel["Admin panel"]
end

node_client(("Client or creator"))

node_client -->|"opens app"| node_app_entry
node_app_entry -->|"provides access"| node_authentication
node_authentication -->|"enters marketplace"| node_discovery
node_discovery -->|"opens profiles"| node_profiles
node_profiles -->|"views offerings"| node_services
node_profiles -->|"views portfolios"| node_posts
node_client -->|"requests hire"| node_hire
node_hire -->|"supports engagement"| node_chat
node_hire -->|"enables reviews"| node_reviews
node_hire -->|"notifies users"| node_notifications
node_client -->|"chats directly"| node_chat
node_client -->|"reports user"| node_reports
node_app_entry -->|"initializes backend"| node_firebase
node_cloud_functions -->|"checks requests"| node_validators
node_cloud_functions -->|"reads and writes"| node_firebase
node_firebase -->|"triggers functions"| node_cloud_functions
node_app_entry -.->|"configures storage"| node_supabase_storage
node_client -->|"admin access"| node_admin_entry
node_admin_entry -->|"opens panel"| node_admin_panel
node_admin_panel -.->|"manages platform"| node_firebase

click node_app_entry "https://github.com/alihasnain-se/design-build-hub/blob/main/lib/main.dart"
click node_authentication "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/auth"
click node_discovery "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/discovery"
click node_profiles "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/designer_profile"
click node_services "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/services"
click node_posts "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/posts"
click node_hire "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/hire_requests"
click node_chat "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/chat"
click node_reviews "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/reviews"
click node_notifications "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/notifications"
click node_reports "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/reports"
click node_cloud_functions "https://github.com/alihasnain-se/design-build-hub/blob/main/functions/src/index.ts"
click node_validators "https://github.com/alihasnain-se/design-build-hub/blob/main/functions/src/validators.ts"
click node_supabase_storage "https://github.com/alihasnain-se/design-build-hub/blob/main/lib/core/storage/supabase_storage_service.dart"
click node_admin_entry "https://github.com/alihasnain-se/design-build-hub/blob/main/lib/admin_main.dart"
click node_admin_panel "https://github.com/alihasnain-se/design-build-hub/tree/main/lib/admin"

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_app_entry,node_authentication,node_client toneBlue
class node_discovery,node_profiles,node_services,node_posts toneAmber
class node_hire,node_chat,node_reviews,node_notifications,node_reports toneMint
class node_cloud_functions,node_validators,node_firebase,node_supabase_storage toneRose
class node_admin_entry,node_admin_panel toneIndigo
```

## Components

### Flutter App

- [App entry](https://github.com/alihasnain-se/design-build-hub/blob/main/lib/main.dart): `lib/main.dart`
- [Authentication](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/auth): `lib/features/auth`

### Marketplace

- [Professional discovery](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/discovery): `lib/features/discovery`
- [Professional profiles](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/designer_profile): `lib/features/designer_profile`
- [Services and pricing](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/services): `lib/features/services`
- [Portfolio posts](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/posts): `lib/features/posts`

### Project Engagement

- [Hire requests](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/hire_requests): `lib/features/hire_requests`
- [In-app chat](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/chat): `lib/features/chat`
- [Reviews](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/reviews): `lib/features/reviews`
- [Notifications](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/notifications): `lib/features/notifications`
- [User reports](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/features/reports): `lib/features/reports`

### Backend Services

- [Cloud Functions](https://github.com/alihasnain-se/design-build-hub/blob/main/functions/src/index.ts): `functions/src/index.ts`
- [Request validators](https://github.com/alihasnain-se/design-build-hub/blob/main/functions/src/validators.ts): `functions/src/validators.ts`
- **Firebase services**
- [Supabase storage](https://github.com/alihasnain-se/design-build-hub/blob/main/lib/core/storage/supabase_storage_service.dart): `lib/core/storage/supabase_storage_service.dart`

### Administration

- [Admin entry](https://github.com/alihasnain-se/design-build-hub/blob/main/lib/admin_main.dart): `lib/admin_main.dart`
- [Admin panel](https://github.com/alihasnain-se/design-build-hub/tree/main/lib/admin): `lib/admin`

### Other components

- **Client or creator**

## Connections

- Client or creator → App entry: opens app (evidence: `README.md`)
- App entry → Authentication: provides access (evidence: `README.md`)
- Authentication → Professional discovery: enters marketplace (evidence: `README.md`)
- Professional discovery → Professional profiles: opens profiles (evidence: `README.md`)
- Professional profiles → Services and pricing: views offerings (evidence: `README.md`)
- Professional profiles → Portfolio posts: views portfolios (evidence: `README.md`)
- Client or creator → Hire requests: requests hire (evidence: `README.md`)
- Hire requests → In-app chat: supports engagement (evidence: `README.md`)
- Hire requests → Reviews: enables reviews (evidence: `README.md`)
- Hire requests → Notifications: notifies users (evidence: `README.md`)
- Client or creator → In-app chat: chats directly (evidence: `README.md`)
- Client or creator → User reports: reports user (evidence: `README.md`)
- App entry → Firebase services: initializes backend (evidence: `README.md`)
- Cloud Functions → Request validators: checks requests (evidence: `functions/src/index.ts`)
- Cloud Functions → Firebase services: reads and writes (evidence: `functions/src/index.ts`)
- Firebase services → Cloud Functions: triggers functions (evidence: `functions/src/index.ts`)
- App entry → Supabase storage: configures storage (evidence: `README.md`)
- Client or creator → Admin entry: admin access (evidence: `README.md`)
- Admin entry → Admin panel: opens panel (evidence: `README.md`)
- Admin panel → Firebase services: manages platform (evidence: `README.md`)
