# mags-001/mags-ai architecture

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

- Interactive diagram: https://gitdiagram.com/mags-001/mags-ai
- Repository: https://github.com/mags-001/mags-ai

## Overview

Mags.Ai is a single-page marketing site for a digital-solutions business, not an implemented service-delivery platform. Visitors browse business problems, services, product concepts, the project process, testimonials, and FAQs, then can fill out a contact enquiry. The contact form validates locally and displays a success state, but explicitly does not send or store submissions. The graph reflects the shown React composition and documented imports; no backend or external service is evidenced.

Main entry points: [`src/App.tsx`](https://github.com/mags-001/mags-ai/blob/master/src/App.tsx) (Page composition), [`src/sections/Testimonials.tsx`](https://github.com/mags-001/mags-ai/blob/master/src/sections/Testimonials.tsx) (Testimonials), [`src/sections/Services.tsx`](https://github.com/mags-001/mags-ai/blob/master/src/sections/Services.tsx) (Services), [`src/sections/Products.tsx`](https://github.com/mags-001/mags-ai/blob/master/src/sections/Products.tsx) (Products)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site composition"]
  node_app["Page composition<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
end

subgraph group_capabilities["Business capabilities"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_problems["Problems<br/>[Problems.tsx]"]
  node_problemcard["Problem card<br/>[ProblemCard.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_services["Services<br/>[Services.tsx]"]
  node_servicecard["Service card<br/>[ServiceCard.tsx]"]
  node_servicesdata["Service content<br/>[services.ts]"]
  node_products["Products<br/>[Products.tsx]"]
  node_productdata["Product content<br/>[products.ts]"]
  node_productcard["Product card<br/>[ProductCard.tsx]"]
  node_productpreview["Product preview<br/>[ProductPreview.tsx]"]
  node_productstatus["Product status<br/>[ProductStatus.tsx]"]
  node_process["Project process<br/>[Process.tsx]"]
  node_processdata["Process steps<br/>[process.ts]"]
  node_processtimeline["Process timeline"]
end

subgraph group_inquiry["Trust and inquiry"]
  node_testimonials["Testimonials<br/>[Testimonials.tsx]"]
  node_testimonialdata["Client stories<br/>[testimonials.ts]"]
  node_clientcard["Client card<br/>[ClientCard.tsx]"]
  node_testimonialcard["Testimonial card"]
  node_emptystate["Empty state<br/>[EmptyState.tsx]"]
  node_faq["FAQ<br/>[FAQ.tsx]"]
  node_faqdata["FAQ content<br/>[faqs.ts]"]
  node_faqitem["FAQ item<br/>[FAQItem.tsx]"]
  node_contact["Contact enquiry<br/>[Contact.tsx]"]
  node_contactdata["Contact links<br/>[contact.ts]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

node_visitor(("Site visitor"))

node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_problems
node_app -->|"renders"| node_about
node_app -->|"renders"| node_services
node_app -->|"renders"| node_products
node_app -->|"renders"| node_process
node_app -->|"renders"| node_testimonials
node_app -->|"renders"| node_faq
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_problems -->|"renders"| node_problemcard
node_services -->|"reads"| node_servicesdata
node_services -->|"renders"| node_servicecard
node_products -->|"reads"| node_productdata
node_products -->|"renders"| node_productcard
node_productcard -->|"renders"| node_productpreview
node_productcard -->|"renders"| node_productstatus
node_process -->|"reads"| node_processdata
node_process -->|"renders"| node_processtimeline
node_testimonials -->|"reads"| node_testimonialdata
node_testimonials -->|"renders"| node_clientcard
node_testimonials -->|"renders"| node_testimonialcard
node_testimonials -->|"renders"| node_emptystate
node_faq -->|"reads"| node_faqdata
node_faq -->|"renders"| node_faqitem
node_contact -->|"reads"| node_contactdata
node_footer -->|"reads"| node_contactdata
node_visitor -->|"submits form"| node_contact

click node_app "https://github.com/mags-001/mags-ai/blob/master/src/App.tsx"
click node_navbar "https://github.com/mags-001/mags-ai/blob/master/src/components/Navbar.tsx"
click node_hero "https://github.com/mags-001/mags-ai/blob/master/src/sections/Hero.tsx"
click node_problems "https://github.com/mags-001/mags-ai/blob/master/src/sections/Problems.tsx"
click node_problemcard "https://github.com/mags-001/mags-ai/blob/master/src/components/ProblemCard.tsx"
click node_about "https://github.com/mags-001/mags-ai/blob/master/src/sections/About.tsx"
click node_services "https://github.com/mags-001/mags-ai/blob/master/src/sections/Services.tsx"
click node_servicecard "https://github.com/mags-001/mags-ai/blob/master/src/components/ServiceCard.tsx"
click node_servicesdata "https://github.com/mags-001/mags-ai/blob/master/src/data/services.ts"
click node_products "https://github.com/mags-001/mags-ai/blob/master/src/sections/Products.tsx"
click node_productdata "https://github.com/mags-001/mags-ai/blob/master/src/data/products.ts"
click node_productcard "https://github.com/mags-001/mags-ai/blob/master/src/components/ProductCard.tsx"
click node_productpreview "https://github.com/mags-001/mags-ai/blob/master/src/components/ProductPreview.tsx"
click node_productstatus "https://github.com/mags-001/mags-ai/blob/master/src/components/ProductStatus.tsx"
click node_process "https://github.com/mags-001/mags-ai/blob/master/src/sections/Process.tsx"
click node_processdata "https://github.com/mags-001/mags-ai/blob/master/src/data/process.ts"
click node_processtimeline "https://github.com/mags-001/mags-ai/blob/master/src/components/ProcessTimeline.tsx"
click node_testimonials "https://github.com/mags-001/mags-ai/blob/master/src/sections/Testimonials.tsx"
click node_testimonialdata "https://github.com/mags-001/mags-ai/blob/master/src/data/testimonials.ts"
click node_clientcard "https://github.com/mags-001/mags-ai/blob/master/src/components/ClientCard.tsx"
click node_testimonialcard "https://github.com/mags-001/mags-ai/blob/master/src/components/TestimonialCard.tsx"
click node_emptystate "https://github.com/mags-001/mags-ai/blob/master/src/components/EmptyState.tsx"
click node_faq "https://github.com/mags-001/mags-ai/blob/master/src/sections/FAQ.tsx"
click node_faqdata "https://github.com/mags-001/mags-ai/blob/master/src/data/faqs.ts"
click node_faqitem "https://github.com/mags-001/mags-ai/blob/master/src/components/FAQItem.tsx"
click node_contact "https://github.com/mags-001/mags-ai/blob/master/src/sections/Contact.tsx"
click node_contactdata "https://github.com/mags-001/mags-ai/blob/master/src/data/contact.ts"
click node_footer "https://github.com/mags-001/mags-ai/blob/master/src/sections/Footer.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_app,node_navbar toneBlue
class node_hero,node_problems,node_problemcard,node_about,node_services,node_servicecard,node_servicesdata,node_products,node_productdata,node_productcard,node_productpreview,node_productstatus,node_process,node_processdata,node_processtimeline toneAmber
class node_testimonials,node_testimonialdata,node_clientcard,node_testimonialcard,node_emptystate,node_faq,node_faqdata,node_faqitem,node_contact,node_contactdata,node_footer toneMint
class node_visitor toneIndigo
```

## Components

### Site composition

- [Page composition](https://github.com/mags-001/mags-ai/blob/master/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/mags-001/mags-ai/blob/master/src/components/Navbar.tsx): `src/components/Navbar.tsx`

### Business capabilities

- [Hero](https://github.com/mags-001/mags-ai/blob/master/src/sections/Hero.tsx): `src/sections/Hero.tsx`
- [Problems](https://github.com/mags-001/mags-ai/blob/master/src/sections/Problems.tsx): `src/sections/Problems.tsx`
- [Problem card](https://github.com/mags-001/mags-ai/blob/master/src/components/ProblemCard.tsx): `src/components/ProblemCard.tsx`
- [About](https://github.com/mags-001/mags-ai/blob/master/src/sections/About.tsx): `src/sections/About.tsx`
- [Services](https://github.com/mags-001/mags-ai/blob/master/src/sections/Services.tsx): `src/sections/Services.tsx`
- [Service card](https://github.com/mags-001/mags-ai/blob/master/src/components/ServiceCard.tsx): `src/components/ServiceCard.tsx`
- [Service content](https://github.com/mags-001/mags-ai/blob/master/src/data/services.ts): `src/data/services.ts`
- [Products](https://github.com/mags-001/mags-ai/blob/master/src/sections/Products.tsx): `src/sections/Products.tsx`
- [Product content](https://github.com/mags-001/mags-ai/blob/master/src/data/products.ts): `src/data/products.ts`
- [Product card](https://github.com/mags-001/mags-ai/blob/master/src/components/ProductCard.tsx): `src/components/ProductCard.tsx`
- [Product preview](https://github.com/mags-001/mags-ai/blob/master/src/components/ProductPreview.tsx): `src/components/ProductPreview.tsx`
- [Product status](https://github.com/mags-001/mags-ai/blob/master/src/components/ProductStatus.tsx): `src/components/ProductStatus.tsx`
- [Project process](https://github.com/mags-001/mags-ai/blob/master/src/sections/Process.tsx): `src/sections/Process.tsx`
- [Process steps](https://github.com/mags-001/mags-ai/blob/master/src/data/process.ts): `src/data/process.ts`
- [Process timeline](https://github.com/mags-001/mags-ai/blob/master/src/components/ProcessTimeline.tsx): `src/components/ProcessTimeline.tsx`

### Trust and inquiry

- [Testimonials](https://github.com/mags-001/mags-ai/blob/master/src/sections/Testimonials.tsx): `src/sections/Testimonials.tsx`
- [Client stories](https://github.com/mags-001/mags-ai/blob/master/src/data/testimonials.ts): `src/data/testimonials.ts`
- [Client card](https://github.com/mags-001/mags-ai/blob/master/src/components/ClientCard.tsx): `src/components/ClientCard.tsx`
- [Testimonial card](https://github.com/mags-001/mags-ai/blob/master/src/components/TestimonialCard.tsx): `src/components/TestimonialCard.tsx`
- [Empty state](https://github.com/mags-001/mags-ai/blob/master/src/components/EmptyState.tsx): `src/components/EmptyState.tsx`
- [FAQ](https://github.com/mags-001/mags-ai/blob/master/src/sections/FAQ.tsx): `src/sections/FAQ.tsx`
- [FAQ content](https://github.com/mags-001/mags-ai/blob/master/src/data/faqs.ts): `src/data/faqs.ts`
- [FAQ item](https://github.com/mags-001/mags-ai/blob/master/src/components/FAQItem.tsx): `src/components/FAQItem.tsx`
- [Contact enquiry](https://github.com/mags-001/mags-ai/blob/master/src/sections/Contact.tsx): `src/sections/Contact.tsx`
- [Contact links](https://github.com/mags-001/mags-ai/blob/master/src/data/contact.ts): `src/data/contact.ts`
- [Footer](https://github.com/mags-001/mags-ai/blob/master/src/sections/Footer.tsx): `src/sections/Footer.tsx`

### Other components

- **Site visitor**

## Connections

- Page composition → Navigation: renders (evidence: `src/App.tsx`)
- Page composition → Hero: renders (evidence: `src/App.tsx`)
- Page composition → Problems: renders (evidence: `src/App.tsx`)
- Page composition → About: renders (evidence: `src/App.tsx`)
- Page composition → Services: renders (evidence: `src/App.tsx`)
- Page composition → Products: renders (evidence: `src/App.tsx`)
- Page composition → Project process: renders (evidence: `src/App.tsx`)
- Page composition → Testimonials: renders (evidence: `src/App.tsx`)
- Page composition → FAQ: renders (evidence: `src/App.tsx`)
- Page composition → Contact enquiry: renders (evidence: `src/App.tsx`)
- Page composition → Footer: renders (evidence: `src/App.tsx`)
- Problems → Problem card: renders (evidence: `src/sections/Problems.tsx`)
- Services → Service content: reads (evidence: `src/sections/Services.tsx`)
- Services → Service card: renders (evidence: `src/sections/Services.tsx`)
- Products → Product content: reads (evidence: `src/sections/Products.tsx`)
- Products → Product card: renders (evidence: `src/sections/Products.tsx`)
- Product card → Product preview: renders (evidence: `src/components/ProductCard.tsx`)
- Product card → Product status: renders (evidence: `src/components/ProductCard.tsx`)
- Project process → Process steps: reads (evidence: `src/sections/Process.tsx`)
- Project process → Process timeline: renders (evidence: `src/sections/Process.tsx`)
- Testimonials → Client stories: reads (evidence: `src/sections/Testimonials.tsx`)
- Testimonials → Client card: renders (evidence: `src/sections/Testimonials.tsx`)
- Testimonials → Testimonial card: renders (evidence: `src/sections/Testimonials.tsx`)
- Testimonials → Empty state: renders (evidence: `src/sections/Testimonials.tsx`)
- FAQ → FAQ content: reads (evidence: `src/sections/FAQ.tsx`)
- FAQ → FAQ item: renders (evidence: `src/sections/FAQ.tsx`)
- Contact enquiry → Contact links: reads (evidence: `src/sections/Contact.tsx`)
- Footer → Contact links: reads (evidence: `src/sections/Footer.tsx`)
- Site visitor → Contact enquiry: submits form (evidence: `src/sections/Contact.tsx`)
