# devjanith/abc-paints architecture

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

- Interactive diagram: https://gitdiagram.com/devjanith/abc-paints
- Repository: https://github.com/devjanith/abc-paints

## Overview

ABC Paints is a bilingual React business website for presenting paint products and services, finding sellers, estimating materials, and contacting the company. The principal visitor flow is browser entry → routed page within the shared layout → product or seller information fetched from Google Sheets, or a contact/contractor submission handled through the API service. The calculator component exists, but the current `/calculator` route renders ComingSoon rather than CalculatorPage. Relationships for unsampled page implementations are limited to SOURCE INDEX references; the README documents the external integrations.

Main entry points: [`src/App.tsx`](https://github.com/devjanith/abc-paints/blob/main/src/App.tsx) (Routes), [`src/services/api.ts`](https://github.com/devjanith/abc-paints/blob/main/src/services/api.ts) (Data and forms API), [`src/components/SEO.tsx`](https://github.com/devjanith/abc-paints/blob/main/src/components/SEO.tsx) (SEO metadata), [`src/components/layout/Layout.tsx`](https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Layout.tsx) (Shared layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_routing["Routes<br/>[App.tsx]"]
  node_layout["Shared layout<br/>[Layout.tsx]"]
  node_header["Header<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_credits["Credits<br/>[Credits.tsx]"]
end

subgraph group_business["Business pages"]
  node_home["Home<br/>[Home.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_services["Services<br/>[Services.tsx]"]
  node_contact["Contact<br/>[Contact.tsx]"]
  node_contractors["Contractors<br/>[Contractors.tsx]"]
end

subgraph group_catalog["Catalog and locations"]
  node_products["Products page<br/>[Products.tsx]"]
  node_paintcolors["Paint colors<br/>[PaintsColors.tsx]"]
  node_productgrid["Product grid<br/>[ProductGrid.tsx]"]
  node_productcard["Product card<br/>[ProductCard.tsx]"]
  node_calculator["Calculator<br/>[Calculator.tsx]"]
  node_calculatorpage["Calculator page<br/>[CalculatorPage.tsx]"]
  node_comingsoon["Coming soon<br/>[ComingSoon.tsx]"]
  node_locations["Locations<br/>[Locations.tsx]"]
  node_sellers["Seller map<br/>[Sellers.tsx]"]
end

subgraph group_shared["Shared services"]
  node_api["Data and forms API<br/>[api.ts]"]
  node_seo["SEO metadata<br/>[SEO.tsx]"]
  node_i18n["Translations<br/>[i18n.ts]"]
  node_siteconfig["Site configuration<br/>[site.ts]"]
  node_partners["Trusted partners"]
end

node_visitor(("Site visitor"))
node_sheets[("Google Sheets")]
node_apps_script{{"Google Apps Script"}}

node_visitor -->|"opens site"| node_entry
node_entry -->|"renders"| node_routing
node_routing -->|"wraps routes"| node_layout
node_routing -->|"routes to"| node_home
node_routing -->|"routes to"| node_about
node_routing -->|"routes to"| node_products
node_routing -->|"routes to"| node_paintcolors
node_routing -->|"routes to"| node_services
node_routing -->|"routes to"| node_contractors
node_routing -->|"routes to"| node_locations
node_routing -->|"routes to"| node_sellers
node_routing -->|"routes to"| node_contact
node_routing -->|"routes calculator to"| node_comingsoon
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_footer
node_layout -->|"renders"| node_credits
node_products -->|"renders"| node_productgrid
node_productgrid -->|"fetches products"| node_api
node_api -->|"reads CSV"| node_sheets
node_productgrid -->|"renders cards"| node_productcard
node_calculator -->|"fetches products"| node_api
node_calculatorpage -->|"renders"| node_calculator
node_sellers -->|"fetches sellers"| node_api
node_contact -->|"submits form"| node_api
node_contractors -->|"submits registration"| node_api
node_api -->|"submits forms"| node_apps_script
node_home -->|"renders"| node_partners
node_home -->|"sets metadata"| node_seo
node_about -->|"sets metadata"| node_seo
node_contact -->|"sets metadata"| node_seo
node_contractors -->|"sets metadata"| node_seo
node_services -->|"sets metadata"| node_seo
node_sellers -->|"sets metadata"| node_seo
node_products -->|"sets metadata"| node_seo
node_footer -->|"reads details"| node_siteconfig
node_locations -.->|"uses config"| node_siteconfig
node_entry -->|"loads translations"| node_i18n

click node_entry "https://github.com/devjanith/abc-paints/blob/main/src/main.tsx"
click node_routing "https://github.com/devjanith/abc-paints/blob/main/src/App.tsx"
click node_layout "https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Layout.tsx"
click node_header "https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Header.tsx"
click node_footer "https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Footer.tsx"
click node_credits "https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Credits.tsx"
click node_home "https://github.com/devjanith/abc-paints/blob/main/src/pages/Home.tsx"
click node_about "https://github.com/devjanith/abc-paints/blob/main/src/pages/About.tsx"
click node_services "https://github.com/devjanith/abc-paints/blob/main/src/pages/Services.tsx"
click node_contact "https://github.com/devjanith/abc-paints/blob/main/src/pages/Contact.tsx"
click node_contractors "https://github.com/devjanith/abc-paints/blob/main/src/pages/Contractors.tsx"
click node_products "https://github.com/devjanith/abc-paints/blob/main/src/pages/Products.tsx"
click node_paintcolors "https://github.com/devjanith/abc-paints/blob/main/src/pages/PaintsColors.tsx"
click node_productgrid "https://github.com/devjanith/abc-paints/blob/main/src/components/ProductGrid.tsx"
click node_productcard "https://github.com/devjanith/abc-paints/blob/main/src/components/ProductCard.tsx"
click node_calculator "https://github.com/devjanith/abc-paints/blob/main/src/components/Calculator.tsx"
click node_calculatorpage "https://github.com/devjanith/abc-paints/blob/main/src/pages/CalculatorPage.tsx"
click node_comingsoon "https://github.com/devjanith/abc-paints/blob/main/src/pages/ComingSoon.tsx"
click node_locations "https://github.com/devjanith/abc-paints/blob/main/src/pages/Locations.tsx"
click node_sellers "https://github.com/devjanith/abc-paints/blob/main/src/pages/Sellers.tsx"
click node_api "https://github.com/devjanith/abc-paints/blob/main/src/services/api.ts"
click node_seo "https://github.com/devjanith/abc-paints/blob/main/src/components/SEO.tsx"
click node_i18n "https://github.com/devjanith/abc-paints/blob/main/src/i18n.ts"
click node_siteconfig "https://github.com/devjanith/abc-paints/blob/main/src/config/site.ts"
click node_partners "https://github.com/devjanith/abc-paints/blob/main/src/components/common/TrustedPartners.tsx"

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_entry,node_routing,node_layout,node_header,node_footer,node_credits toneBlue
class node_home,node_about,node_services,node_contact,node_contractors,node_sheets toneAmber
class node_products,node_paintcolors,node_productgrid,node_productcard,node_calculator,node_calculatorpage,node_comingsoon,node_locations,node_sellers toneMint
class node_api,node_seo,node_i18n,node_siteconfig,node_partners toneRose
class node_visitor,node_apps_script toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/devjanith/abc-paints/blob/main/src/main.tsx): `src/main.tsx`
- [Routes](https://github.com/devjanith/abc-paints/blob/main/src/App.tsx): `src/App.tsx`
- [Shared layout](https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Layout.tsx): `src/components/layout/Layout.tsx`
- [Header](https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Header.tsx): `src/components/layout/Header.tsx`
- [Footer](https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`
- [Credits](https://github.com/devjanith/abc-paints/blob/main/src/components/layout/Credits.tsx): `src/components/layout/Credits.tsx`

### Business pages

- [Home](https://github.com/devjanith/abc-paints/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [About](https://github.com/devjanith/abc-paints/blob/main/src/pages/About.tsx): `src/pages/About.tsx`
- [Services](https://github.com/devjanith/abc-paints/blob/main/src/pages/Services.tsx): `src/pages/Services.tsx`
- [Contact](https://github.com/devjanith/abc-paints/blob/main/src/pages/Contact.tsx): `src/pages/Contact.tsx`
- [Contractors](https://github.com/devjanith/abc-paints/blob/main/src/pages/Contractors.tsx): `src/pages/Contractors.tsx`

### Catalog and locations

- [Products page](https://github.com/devjanith/abc-paints/blob/main/src/pages/Products.tsx): `src/pages/Products.tsx`
- [Paint colors](https://github.com/devjanith/abc-paints/blob/main/src/pages/PaintsColors.tsx): `src/pages/PaintsColors.tsx`
- [Product grid](https://github.com/devjanith/abc-paints/blob/main/src/components/ProductGrid.tsx): `src/components/ProductGrid.tsx`
- [Product card](https://github.com/devjanith/abc-paints/blob/main/src/components/ProductCard.tsx): `src/components/ProductCard.tsx`
- [Calculator](https://github.com/devjanith/abc-paints/blob/main/src/components/Calculator.tsx): `src/components/Calculator.tsx`
- [Calculator page](https://github.com/devjanith/abc-paints/blob/main/src/pages/CalculatorPage.tsx): `src/pages/CalculatorPage.tsx`
- [Coming soon](https://github.com/devjanith/abc-paints/blob/main/src/pages/ComingSoon.tsx): `src/pages/ComingSoon.tsx`
- [Locations](https://github.com/devjanith/abc-paints/blob/main/src/pages/Locations.tsx): `src/pages/Locations.tsx`
- [Seller map](https://github.com/devjanith/abc-paints/blob/main/src/pages/Sellers.tsx): `src/pages/Sellers.tsx`

### Shared services

- [Data and forms API](https://github.com/devjanith/abc-paints/blob/main/src/services/api.ts): `src/services/api.ts`
- [SEO metadata](https://github.com/devjanith/abc-paints/blob/main/src/components/SEO.tsx): `src/components/SEO.tsx`
- [Translations](https://github.com/devjanith/abc-paints/blob/main/src/i18n.ts): `src/i18n.ts`
- [Site configuration](https://github.com/devjanith/abc-paints/blob/main/src/config/site.ts): `src/config/site.ts`
- [Trusted partners](https://github.com/devjanith/abc-paints/blob/main/src/components/common/TrustedPartners.tsx): `src/components/common/TrustedPartners.tsx`

### Other components

- **Site visitor**
- **Google Sheets**
- **Google Apps Script**

## Connections

- Site visitor → React entry: opens site (evidence: `src/main.tsx`)
- React entry → Routes: renders (evidence: `src/main.tsx`)
- Routes → Shared layout: wraps routes (evidence: `src/App.tsx`)
- Routes → Home: routes to (evidence: `src/App.tsx`)
- Routes → About: routes to (evidence: `src/App.tsx`)
- Routes → Products page: routes to (evidence: `src/App.tsx`)
- Routes → Paint colors: routes to (evidence: `src/App.tsx`)
- Routes → Services: routes to (evidence: `src/App.tsx`)
- Routes → Contractors: routes to (evidence: `src/App.tsx`)
- Routes → Locations: routes to (evidence: `src/App.tsx`)
- Routes → Seller map: routes to (evidence: `src/App.tsx`)
- Routes → Contact: routes to (evidence: `src/App.tsx`)
- Routes → Coming soon: routes calculator to (evidence: `src/App.tsx`)
- Shared layout → Header: renders (evidence: `src/components/layout/Layout.tsx`)
- Shared layout → Footer: renders (evidence: `src/components/layout/Layout.tsx`)
- Shared layout → Credits: renders (evidence: `src/components/layout/Layout.tsx`)
- Products page → Product grid: renders (evidence: `src/pages/Products.tsx`)
- Product grid → Data and forms API: fetches products (evidence: `src/components/ProductGrid.tsx`)
- Data and forms API → Google Sheets: reads CSV (evidence: `README.md`)
- Product grid → Product card: renders cards (evidence: `src/components/ProductGrid.tsx`)
- Calculator → Data and forms API: fetches products (evidence: `src/components/Calculator.tsx`)
- Calculator page → Calculator: renders (evidence: `src/pages/CalculatorPage.tsx`)
- Seller map → Data and forms API: fetches sellers (evidence: `src/pages/Sellers.tsx`)
- Contact → Data and forms API: submits form (evidence: `src/pages/Contact.tsx`)
- Contractors → Data and forms API: submits registration (evidence: `README.md`)
- Data and forms API → Google Apps Script: submits forms (evidence: `README.md`)
- Home → Trusted partners: renders (evidence: `src/pages/Home.tsx`)
- Home → SEO metadata: sets metadata (evidence: `src/pages/Home.tsx`)
- About → SEO metadata: sets metadata (evidence: `src/pages/About.tsx`)
- Contact → SEO metadata: sets metadata (evidence: `src/pages/Contact.tsx`)
- Contractors → SEO metadata: sets metadata (evidence: `src/pages/Contractors.tsx`)
- Services → SEO metadata: sets metadata (evidence: `src/pages/Services.tsx`)
- Seller map → SEO metadata: sets metadata (evidence: `src/pages/Sellers.tsx`)
- Products page → SEO metadata: sets metadata (evidence: `src/pages/Products.tsx`)
- Footer → Site configuration: reads details (evidence: `src/components/layout/Footer.tsx`)
- Locations → Site configuration: uses config (evidence: `src/pages/Locations.tsx`)
- React entry → Translations: loads translations (evidence: `src/main.tsx`)
