# rocoaf/web_project_coffeeshop architecture

> Architecture diagram of the GitHub repository rocoaf/web_project_coffeeshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rocoaf/web_project_coffeeshop
- Repository: https://github.com/rocoaf/web_project_coffeeshop

## Overview

##### Project type and purpose
- This is a static, front-end–only “marketing” or informational website built from scratch using HTML5 and CSS3.
- It employs the BEM naming convention for modular, reusable CSS (blocks/, pages/), and demonstrates advanced HTML features (forms, pseudo-classes, embedded content).

##### File structure
- Top level:
- index.html – the main entry point
- pages/ – page-specific CSS (e.g., pages/index.css)
- blocks/ – independent CSS modules for each UI component (header, nav, form, footer, recipes, reservation, page)
- images/ – static image assets
- vendor/ – any third-party scripts or styles (currently empty)
- README.md, .editorconfig, .gitignore, .prettierignore, VSCode settings
- No backend code or build pipeline—purely client-side.

##### README insights
- Confirms usage of BEM, custom HTML & CSS, advanced form embedding and pseudo-classes.
- Future enhancement: real external links (e.g., Facebook).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entities
    Browser["Browser"]:::html
    WebServer["Web Server / CDN"]:::html
    Index["index.html"]:::html

    %% CSS Modules
    subgraph "CSS Modules"
        Header["Header Block"]:::css
        Nav["Navigation Block"]:::css
        Form["Form Block"]:::css
        Footer["Footer Block"]:::css
        Recipes["Recipes Block"]:::css
        Reservation["Reservation Block"]:::css
        PageWrapper["Page Wrapper Block"]:::css
    end

    %% Page-Specific Styles
    subgraph "Page-Specific Styles"
        HomePage["Home Page Styles"]:::css
    end

    %% Static Assets
    subgraph "Static Assets"
        Images["Images Directory"]:::asset
        Vendor["Vendor Directory"]:::asset
    end

    %% External Services
    ExternalService["External Service (e.g., Facebook)"]:::external

    %% Connections
    Browser -->|"GET index.html"| WebServer
    WebServer -->|"Serves index.html"| Index
    Index -->|"link rel=stylesheet"| Header
    Index -->|"link rel=stylesheet"| Nav
    Index -->|"link rel=stylesheet"| Form
    Index -->|"link rel=stylesheet"| Footer
    Index -->|"link rel=stylesheet"| Recipes
    Index -->|"link rel=stylesheet"| Reservation
    Index -->|"link rel=stylesheet"| PageWrapper
    Index -->|"link rel=stylesheet"| HomePage
    Index -->|"optional vendor includes"| Vendor
    Header -->|"may reference images"| Images
    Nav -->|"may reference images"| Images
    Form -->|"may reference images"| Images
    Footer -->|"may reference images"| Images
    Recipes -->|"may reference images"| Images
    Reservation -->|"may reference images"| Images
    PageWrapper -->|"may reference images"| Images
    Footer -->|"future enhancement: external link"| ExternalService

    %% Click Events
    click Index "https://github.com/rocoaf/web_project_coffeeshop/blob/main/index.html"
    click Header "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/header.css"
    click Nav "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/nav.css"
    click Form "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/form.css"
    click Footer "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/footer.css"
    click Recipes "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/recipes.css"
    click Reservation "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/reservation.css"
    click PageWrapper "https://github.com/rocoaf/web_project_coffeeshop/blob/main/blocks/page.css"
    click HomePage "https://github.com/rocoaf/web_project_coffeeshop/blob/main/pages/index.css"
    click Images "https://github.com/rocoaf/web_project_coffeeshop/tree/main/images/"
    click Vendor "https://github.com/rocoaf/web_project_coffeeshop/tree/main/vendor/"

    %% Styles
    classDef html fill:#e0f7ff,stroke:#333,stroke-width:1px
    classDef css fill:#e0ffe0,stroke:#333,stroke-width:1px
    classDef asset fill:#fff0e0,stroke:#333,stroke-width:1px
    classDef external stroke:#f66,stroke-dasharray:5 5,fill:#fee
    class Browser,WebServer,Index html
    class Header,Nav,Form,Footer,Recipes,Reservation,PageWrapper,HomePage css
    class Images,Vendor asset
    class ExternalService external
```
