# ardakaano/masonic architecture

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

- Interactive diagram: https://gitdiagram.com/ardakaano/masonic
- Repository: https://github.com/ardakaano/masonic

## Overview

##### Main Components Structure

A. Client Layer (Browser)
- Entry point (index.html)
- Main bundle (generated from main.tsx)

B. Application Core
- App.tsx as the root component
- Component tree hierarchy
- Asset management
- Styling system

C. Build & Development Tools
- Vite development server
- Build pipeline
- Deployment (Vercel)

##### Detailed Component Organization

**App.tsx**
- Navbar
- Hero
- About
- Services
- Projects
- ProjectModal
- Testimonials
- Contact
- Footer
- BackToTop

##### Technical Stack Integration
Interaction between:
- React + TypeScript
- Tailwind CSS
- Headless UI

##### Key Elements to Highlight

A. Development Flow:
**Source Files → Vite Dev Server → Browser**
- ↓
**TypeScript Compilation**
- ↓
**Asset Processing**
- ↓
**Bundle Generation**

B. Production Build:
**Source → Build → Vercel Deployment → CDN → Client**

##### Important Architectural Aspects

- Single Page Application (SPA) architecture
- Component-based structure
- Static asset handling
- Styling system (Tailwind CSS integration)
- Build optimization pipeline
- Development tools integration

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Browser"]
        Entry["index.html"]:::html
        MainBundle["main.tsx"]:::typescript
    end

    subgraph "Application Core"
        App["App.tsx"]:::react
        
        subgraph "Main Components"
            direction TB
            Navbar["Navbar"]:::react
            Hero["Hero"]:::react
            About["About"]:::react
            Services["Services"]:::react
            Projects["Projects"]:::react
            ProjectModal["ProjectModal"]:::react
            Testimonials["Testimonials"]:::react
            Contact["Contact"]:::react
            Footer["Footer"]:::react
            BackToTop["BackToTop"]:::react
        end

        subgraph "Styling System"
            TailwindConfig["tailwind.config.js"]:::config
            PostCSSConfig["postcss.config.js"]:::config
            AppCSS["App.css"]:::styling
            IndexCSS["index.css"]:::styling
        end
    end

    subgraph "Build & Development"
        ViteServer["Vite Dev Server"]:::build
        ViteConfig["vite.config.ts"]:::config
        TSConfig["tsconfig.json"]:::config
        ESLintConfig["eslint.config.js"]:::config
        PackageJSON["package.json"]:::config
        VercelConfig["vercel.json"]:::config
    end

    %% Relationships
    Browser --> Entry
    Entry --> MainBundle
    MainBundle --> App
    App --> Navbar
    App --> Hero
    App --> About
    App --> Services
    App --> Projects
    App --> Testimonials
    App --> Contact
    App --> Footer
    App --> BackToTop
    Projects --> ProjectModal

    %% Build Flow
    ViteServer --> Browser
    ViteConfig --> ViteServer
    TSConfig --> ViteServer
    
    %% Styling
    TailwindConfig --> App
    PostCSSConfig --> App
    AppCSS --> App
    IndexCSS --> App

    %% Click Events
    click Entry "https://github.com/ardakaano/masonic/blob/main/index.html"
    click MainBundle "https://github.com/ardakaano/masonic/blob/main/src/main.tsx"
    click App "https://github.com/ardakaano/masonic/blob/main/src/App.tsx"
    click Navbar "https://github.com/ardakaano/masonic/blob/main/src/components/Navbar.tsx"
    click Hero "https://github.com/ardakaano/masonic/blob/main/src/components/Hero.tsx"
    click About "https://github.com/ardakaano/masonic/blob/main/src/components/About.tsx"
    click Services "https://github.com/ardakaano/masonic/blob/main/src/components/Services.tsx"
    click Projects "https://github.com/ardakaano/masonic/blob/main/src/components/Projects.tsx"
    click ProjectModal "https://github.com/ardakaano/masonic/blob/main/src/components/ProjectModal.tsx"
    click Testimonials "https://github.com/ardakaano/masonic/blob/main/src/components/Testimonials.tsx"
    click Contact "https://github.com/ardakaano/masonic/blob/main/src/components/Contact.tsx"
    click Footer "https://github.com/ardakaano/masonic/blob/main/src/components/Footer.tsx"
    click BackToTop "https://github.com/ardakaano/masonic/blob/main/src/components/BackToTop.tsx"
    click TailwindConfig "https://github.com/ardakaano/masonic/blob/main/tailwind.config.js"
    click PostCSSConfig "https://github.com/ardakaano/masonic/blob/main/postcss.config.js"
    click AppCSS "https://github.com/ardakaano/masonic/blob/main/src/App.css"
    click IndexCSS "https://github.com/ardakaano/masonic/blob/main/src/index.css"
    click ViteConfig "https://github.com/ardakaano/masonic/blob/main/vite.config.ts"
    click TSConfig "https://github.com/ardakaano/masonic/blob/main/tsconfig.json"
    click ESLintConfig "https://github.com/ardakaano/masonic/blob/main/eslint.config.js"
    click PackageJSON "https://github.com/ardakaano/masonic/blob/main/package.json"
    click VercelConfig "https://github.com/ardakaano/masonic/blob/main/vercel.json"

    %% Styling Classes
    classDef react fill:#61DAFB,stroke:#000000
    classDef typescript fill:#3178C6,stroke:#000000,color:#ffffff
    classDef styling fill:#38B2AC,stroke:#000000
    classDef config fill:#FF6B6B,stroke:#000000
    classDef html fill:#E34F26,stroke:#000000,color:#ffffff
    classDef build fill:#FFD700,stroke:#000000

    %% Legend
    subgraph Legend
        React["React Component"]:::react
        TypeScript["TypeScript File"]:::typescript
        Styling["Styling File"]:::styling
        Config["Config File"]:::config
        HTML["HTML File"]:::html
        Build["Build Tool"]:::build
    end
```
