# nafeeza-25/tiles-digital-platform architecture

> Architecture diagram of the GitHub repository nafeeza-25/tiles-digital-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nafeeza-25/tiles-digital-platform
- Repository: https://github.com/nafeeza-25/tiles-digital-platform

## Overview

Timeless Tiles is a fictional tile-shopping and showroom-discovery demo. Visitors explore a visual catalogue, refine or compare products, receive room-based recommendations, and can view product reviews; they can also submit enquiries or find a showroom. The graph preserves the README’s major capabilities, including guides and SEO. Some routes and subsystems are represented from the README and file tree rather than inspected source, so those links cite the README and uncertain implementation details are omitted.

Main entry points: [`src/app/tiles/page.tsx`](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/page.tsx) (Tile catalogue), [`src/app/recommendations/page.tsx`](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/recommendations/page.tsx) (Room recommendations), [`src/app/contact/page.tsx`](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/contact/page.tsx) (Lead enquiries), [`src/lib/queries/catalog.ts`](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/catalog.ts) (Catalogue query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Product discovery"]
  node_catalogue["Tile catalogue<br/>[page.tsx]"]
  node_category["Category browse<br/>[page.tsx]"]
  node_catalogue_query["Catalogue query<br/>[catalog.ts]"]
  node_catalogue_filters["Search and filters<br/>[catalog-filters.ts]"]
  node_product_detail["Product details<br/>[page.tsx]"]
  node_product_card["Product cards<br/>[ProductCard.tsx]"]
end

subgraph group_engagement["Product engagement"]
  node_comparison["Tile comparison<br/>[page.tsx]"]
  node_compare_state["Comparison state"]
  node_recommendations["Room recommendations<br/>[page.tsx]"]
  node_recommendation_rules["Recommendation rules"]
  node_review_flow["Product reviews<br/>[ReviewForm.tsx]"]
  node_review_validation["Review validation<br/>[review-schema.ts]"]
end

subgraph group_conversion["Enquiries and stores"]
  node_enquiries["Lead enquiries<br/>[page.tsx]"]
  node_enquiry_form["Enquiry form<br/>[EnquiryForm.tsx]"]
  node_enquiry_data["Enquiry persistence<br/>[enquiries.ts]"]
  node_whatsapp["WhatsApp enquiry"]
  node_stores["Store finder<br/>[page.tsx]"]
  node_store_query["Store query<br/>[stores.ts]"]
end

subgraph group_content["Content and platform"]
  node_home["Home experience<br/>[page.tsx]"]
  node_guides["Educational guides<br/>[guides.ts]"]
  node_seo["Technical SEO<br/>[metadata.ts]"]
  node_supabase_client["Supabase clients<br/>[server.ts]"]
  node_database_types["Database schema types<br/>[database.types.ts]"]
end

node_visitor(("Site visitor"))
node_supabase[("Supabase database")]
node_whatsapp_service["WhatsApp"]

node_visitor -->|"browses"| node_catalogue
node_catalogue -->|"loads products"| node_catalogue_query
node_catalogue_query -->|"uses client"| node_supabase_client
node_catalogue_query -->|"uses filters"| node_catalogue_filters
node_catalogue -->|"searches and filters"| node_catalogue_filters
node_catalogue -->|"displays products"| node_product_card
node_visitor -->|"browses category"| node_category
node_visitor -->|"opens product"| node_product_detail
node_product_detail -->|"submits review"| node_review_flow
node_review_flow -->|"validates with"| node_review_validation
node_review_flow -->|"inserts review"| node_supabase
node_visitor -->|"compares tiles"| node_comparison
node_comparison -->|"uses persisted state"| node_compare_state
node_visitor -->|"chooses room"| node_recommendations
node_recommendations -->|"loads products"| node_catalogue_query
node_recommendations -->|"matches preferences"| node_recommendation_rules
node_recommendations -->|"displays results"| node_product_card
node_visitor -->|"requests information"| node_enquiries
node_enquiries -->|"presents form"| node_enquiry_form
node_enquiries -->|"submits lead"| node_enquiry_data
node_enquiry_data -->|"writes enquiry"| node_supabase
node_enquiries -->|"offers chat link"| node_whatsapp
node_whatsapp -->|"opens chat"| node_whatsapp_service
node_visitor -->|"finds showroom"| node_stores
node_stores -->|"loads stores"| node_store_query
node_store_query -->|"uses client"| node_supabase_client
node_visitor -->|"visits"| node_home
node_visitor -->|"reads guides"| node_guides
node_home -->|"sets metadata"| node_seo
node_supabase_client -->|"connects"| node_supabase
node_supabase_client -->|"types client"| node_database_types

click node_catalogue "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/page.tsx"
click node_category "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/%5BcategorySlug%5D/page.tsx"
click node_catalogue_query "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/catalog.ts"
click node_catalogue_filters "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/catalog/catalog-filters.ts"
click node_product_detail "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/%5BcategorySlug%5D/%5BproductSlug%5D/page.tsx"
click node_product_card "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/products/ProductCard.tsx"
click node_comparison "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/compare/page.tsx"
click node_compare_state "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/compare/CompareProvider.tsx"
click node_recommendations "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/recommendations/page.tsx"
click node_recommendation_rules "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/recommendations/room-recommendations.ts"
click node_review_flow "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/reviews/ReviewForm.tsx"
click node_review_validation "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/reviews/review-schema.ts"
click node_enquiries "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/contact/page.tsx"
click node_enquiry_form "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/forms/EnquiryForm.tsx"
click node_enquiry_data "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/enquiries.ts"
click node_whatsapp "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/forms/WhatsAppEnquiryLink.tsx"
click node_stores "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/stores/page.tsx"
click node_store_query "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/stores.ts"
click node_home "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/page.tsx"
click node_guides "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/data/guides.ts"
click node_seo "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/seo/metadata.ts"
click node_supabase_client "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/supabase/server.ts"
click node_database_types "https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/types/database.types.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_catalogue,node_category,node_catalogue_query,node_catalogue_filters,node_product_detail,node_product_card toneBlue
class node_comparison,node_compare_state,node_recommendations,node_recommendation_rules,node_review_flow,node_review_validation,node_supabase toneAmber
class node_enquiries,node_enquiry_form,node_enquiry_data,node_whatsapp,node_stores,node_store_query toneMint
class node_home,node_guides,node_seo,node_supabase_client,node_database_types toneRose
class node_visitor,node_whatsapp_service toneIndigo
```

## Components

### Product discovery

- [Tile catalogue](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/page.tsx): `src/app/tiles/page.tsx`
- [Category browse](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/%5BcategorySlug%5D/page.tsx): `src/app/tiles/[categorySlug]/page.tsx`
- [Catalogue query](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/catalog.ts): `src/lib/queries/catalog.ts`
- [Search and filters](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/catalog/catalog-filters.ts): `src/lib/catalog/catalog-filters.ts`
- [Product details](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/tiles/%5BcategorySlug%5D/%5BproductSlug%5D/page.tsx): `src/app/tiles/[categorySlug]/[productSlug]/page.tsx`
- [Product cards](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/products/ProductCard.tsx): `src/components/products/ProductCard.tsx`

### Product engagement

- [Tile comparison](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/compare/page.tsx): `src/app/compare/page.tsx`
- [Comparison state](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/compare/CompareProvider.tsx): `src/components/compare/CompareProvider.tsx`
- [Room recommendations](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/recommendations/page.tsx): `src/app/recommendations/page.tsx`
- [Recommendation rules](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/recommendations/room-recommendations.ts): `src/lib/recommendations/room-recommendations.ts`
- [Product reviews](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/reviews/ReviewForm.tsx): `src/components/reviews/ReviewForm.tsx`
- [Review validation](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/reviews/review-schema.ts): `src/lib/reviews/review-schema.ts`

### Enquiries and stores

- [Lead enquiries](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/contact/page.tsx): `src/app/contact/page.tsx`
- [Enquiry form](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/forms/EnquiryForm.tsx): `src/components/forms/EnquiryForm.tsx`
- [Enquiry persistence](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/enquiries.ts): `src/lib/queries/enquiries.ts`
- [WhatsApp enquiry](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/components/forms/WhatsAppEnquiryLink.tsx): `src/components/forms/WhatsAppEnquiryLink.tsx`
- [Store finder](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/stores/page.tsx): `src/app/stores/page.tsx`
- [Store query](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/queries/stores.ts): `src/lib/queries/stores.ts`

### Content and platform

- [Home experience](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Educational guides](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/data/guides.ts): `src/data/guides.ts`
- [Technical SEO](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/seo/metadata.ts): `src/lib/seo/metadata.ts`
- [Supabase clients](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Database schema types](https://github.com/nafeeza-25/tiles-digital-platform/blob/main/src/types/database.types.ts): `src/types/database.types.ts`

### Other components

- **Site visitor**
- **Supabase database**
- **WhatsApp**

## Connections

- Site visitor → Tile catalogue: browses (evidence: `README.md`)
- Tile catalogue → Catalogue query: loads products (evidence: `README.md`)
- Catalogue query → Supabase clients: uses client (evidence: `src/lib/queries/catalog.ts`)
- Catalogue query → Search and filters: uses filters (evidence: `src/lib/queries/catalog.ts`)
- Tile catalogue → Search and filters: searches and filters (evidence: `README.md`)
- Tile catalogue → Product cards: displays products (evidence: `README.md`)
- Site visitor → Category browse: browses category (evidence: `README.md`)
- Site visitor → Product details: opens product (evidence: `README.md`)
- Product details → Product reviews: submits review (evidence: `README.md`)
- Product reviews → Review validation: validates with (evidence: `src/components/reviews/ReviewForm.tsx`)
- Product reviews → Supabase database: inserts review (evidence: `src/components/reviews/ReviewForm.tsx`)
- Site visitor → Tile comparison: compares tiles (evidence: `README.md`)
- Tile comparison → Comparison state: uses persisted state (evidence: `README.md`)
- Site visitor → Room recommendations: chooses room (evidence: `README.md`)
- Room recommendations → Catalogue query: loads products (evidence: `src/app/recommendations/page.tsx`)
- Room recommendations → Recommendation rules: matches preferences (evidence: `src/app/recommendations/page.tsx`)
- Room recommendations → Product cards: displays results (evidence: `src/app/recommendations/page.tsx`)
- Site visitor → Lead enquiries: requests information (evidence: `README.md`)
- Lead enquiries → Enquiry form: presents form (evidence: `src/app/contact/page.tsx`)
- Lead enquiries → Enquiry persistence: submits lead (evidence: `src/app/contact/page.tsx`)
- Enquiry persistence → Supabase database: writes enquiry (evidence: `README.md`)
- Lead enquiries → WhatsApp enquiry: offers chat link (evidence: `src/app/contact/page.tsx`)
- WhatsApp enquiry → WhatsApp: opens chat (evidence: `README.md`)
- Site visitor → Store finder: finds showroom (evidence: `README.md`)
- Store finder → Store query: loads stores (evidence: `src/app/stores/page.tsx`)
- Store query → Supabase clients: uses client (evidence: `src/lib/queries/stores.ts`)
- Site visitor → Home experience: visits (evidence: `README.md`)
- Site visitor → Educational guides: reads guides (evidence: `README.md`)
- Home experience → Technical SEO: sets metadata (evidence: `src/app/page.tsx`)
- Supabase clients → Supabase database: connects (evidence: `src/lib/supabase/server.ts`)
- Supabase clients → Database schema types: types client (evidence: `src/lib/supabase/server.ts`)
