# ibtisamadnan16-oss/handicraft-1st-semester-project architecture

> Architecture diagram of the GitHub repository ibtisamadnan16-oss/handicraft-1st-semester-project, 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/ibtisamadnan16-oss/handicraft-1st-semester-project
- Repository: https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project

## Overview

Venus Handicrafts is a static, multi-page showcase for artisan products and export inquiries, not an online checkout system. Visitors browse the company story and product catalog, inspect product details or gallery images, consult FAQs, and contact the business. The README documents the pages and their capabilities; the sampled JavaScript confirms client-side catalog filtering, product modals, gallery filtering/lightbox navigation, and contact validation. HTML wiring was not sampled, so page-to-page transitions are not asserted.

Main entry points: [`css/style.css`](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/css/style.css) (Site Styling), [`contact.html`](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/contact.html) (Contact Page), [`index.html`](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/index.html) (Home Showcase), [`gallery.html`](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/gallery.html) (Artisan Gallery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_showcase["Showcase Pages"]
  node_home["Home Showcase<br/>[index.html]"]
  node_about["Company Story<br/>[about.html]"]
  node_catalog["Product Catalog<br/>[products.html]"]
  node_gallery["Artisan Gallery<br/>[gallery.html]"]
end

subgraph group_buyer["Buyer Information"]
  node_faq["Export FAQ<br/>[faq.html]"]
  node_contact["Contact Page<br/>[contact.html]"]
  node_sitemap["Site Map<br/>[sitemap.html]"]
end

subgraph group_interaction["Client Interactions"]
  node_product_details["Product Details<br/>[main.js]"]
  node_gallery_lightbox["Gallery Lightbox<br/>[main.js]"]
  node_contact_validation["Contact Validation<br/>[main.js]"]
  node_ui_behavior["Shared UI Behavior<br/>[main.js]"]
end

subgraph group_presentation["Presentation Assets"]
  node_theme["Site Styling<br/>[style.css]"]
  node_product_images["Product Images"]
end

node_visitor(("Visitor"))
node_email_desk(("Business Email Desk"))
node_maps["Google Maps Embed"]

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_catalog
node_visitor -->|"browses"| node_gallery
node_visitor -->|"consults"| node_faq
node_visitor -->|"contacts"| node_contact
node_visitor -->|"learns about"| node_about
node_visitor -->|"views"| node_sitemap
node_catalog -->|"opens details"| node_product_details
node_gallery -->|"opens preview"| node_gallery_lightbox
node_contact -->|"validates form"| node_contact_validation
node_contact -->|"directs inquiries"| node_email_desk
node_contact -.->|"embeds location"| node_maps
node_home -->|"showcases items"| node_product_images
node_gallery -->|"displays photos"| node_product_images
node_home -->|"uses styling"| node_theme
node_about -->|"uses styling"| node_theme
node_catalog -->|"uses styling"| node_theme
node_gallery -->|"uses styling"| node_theme
node_faq -->|"uses styling"| node_theme
node_contact -->|"uses styling"| node_theme
node_sitemap -->|"uses styling"| node_theme
node_home -.->|"uses interactions"| node_ui_behavior

click node_home "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/index.html"
click node_about "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/about.html"
click node_catalog "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/products.html"
click node_gallery "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/gallery.html"
click node_faq "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/faq.html"
click node_contact "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/contact.html"
click node_sitemap "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/sitemap.html"
click node_product_details "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js"
click node_gallery_lightbox "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js"
click node_contact_validation "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js"
click node_ui_behavior "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js"
click node_theme "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/css/style.css"
click node_product_images "https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/tree/main/images"

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_about,node_catalog,node_gallery toneBlue
class node_faq,node_contact,node_sitemap toneAmber
class node_product_details,node_gallery_lightbox,node_contact_validation,node_ui_behavior toneMint
class node_theme,node_product_images toneRose
class node_visitor,node_email_desk,node_maps toneIndigo
```

## Components

### Showcase Pages

- [Home Showcase](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/index.html): `index.html`
- [Company Story](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/about.html): `about.html`
- [Product Catalog](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/products.html): `products.html`
- [Artisan Gallery](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/gallery.html): `gallery.html`

### Buyer Information

- [Export FAQ](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/faq.html): `faq.html`
- [Contact Page](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/contact.html): `contact.html`
- [Site Map](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/sitemap.html): `sitemap.html`

### Client Interactions

- [Product Details](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js): `js/main.js`
- [Gallery Lightbox](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js): `js/main.js`
- [Contact Validation](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js): `js/main.js`
- [Shared UI Behavior](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/js/main.js): `js/main.js`

### Presentation Assets

- [Site Styling](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/blob/main/css/style.css): `css/style.css`
- [Product Images](https://github.com/ibtisamadnan16-oss/handicraft-1st-semester-project/tree/main/images): `images`

### Other components

- **Visitor**
- **Business Email Desk**
- **Google Maps Embed**

## Connections

- Visitor → Home Showcase: browses (evidence: `README.md`)
- Visitor → Product Catalog: browses (evidence: `README.md`)
- Visitor → Artisan Gallery: browses (evidence: `README.md`)
- Visitor → Export FAQ: consults (evidence: `README.md`)
- Visitor → Contact Page: contacts (evidence: `README.md`)
- Visitor → Company Story: learns about (evidence: `README.md`)
- Visitor → Site Map: views (evidence: `README.md`)
- Product Catalog → Product Details: opens details (evidence: `js/main.js`)
- Artisan Gallery → Gallery Lightbox: opens preview (evidence: `js/main.js`)
- Contact Page → Contact Validation: validates form (evidence: `js/main.js`)
- Contact Page → Business Email Desk: directs inquiries (evidence: `README.md`)
- Contact Page → Google Maps Embed: embeds location (evidence: `README.md`)
- Home Showcase → Product Images: showcases items (evidence: `README.md`)
- Artisan Gallery → Product Images: displays photos (evidence: `README.md`)
- Home Showcase → Site Styling: uses styling (evidence: `README.md`)
- Company Story → Site Styling: uses styling (evidence: `README.md`)
- Product Catalog → Site Styling: uses styling (evidence: `README.md`)
- Artisan Gallery → Site Styling: uses styling (evidence: `README.md`)
- Export FAQ → Site Styling: uses styling (evidence: `README.md`)
- Contact Page → Site Styling: uses styling (evidence: `README.md`)
- Site Map → Site Styling: uses styling (evidence: `README.md`)
- Home Showcase → Shared UI Behavior: uses interactions
