# ras-bmsit/sop25 architecture

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

- Interactive diagram: https://gitdiagram.com/ras-bmsit/sop25
- Repository: https://github.com/ras-bmsit/sop25

## Overview

##### Project type and purpose
- This is a single-page, static-site frontend application built with React, TypeScript, Vite, Tailwind CSS, and shadcn-ui.
- It has no custom backend/API—it’s a marketing/event site (SOP25) that gets built into static assets and deployed to GitHub Pages.

##### File structure
- Top level:
- public/ → static files (robots.txt, favicon, index.html template)
- src/ → application source:
– components/ → page‐specific React components (Hero, Navbar, Footer, etc.)
– components/ui/ → shadcn‐ui primitives (buttons, dialogs, menus, etc.)
– pages/ → route entry points (Index.tsx, NotFound.tsx)
– hooks/ and lib/ → shared logic (useToast, useMobile, utils.ts)
– main.tsx → app‐bootstrap (ReactDOM.render, router)
- config files: vite.config.ts, tailwind.config.ts, tsconfig.json
- package.json / npm scripts (dev, build, deploy via gh-pages)

##### README for additional insights
- Confirms tech stack and deployment to GitHub Pages with the gh-pages npm package.
- No custom servers or microservices—purely a frontend workflow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Developer Environment"
        DEV["Node.js & npm"]:::dev
        REPO["Source Repository (GitHub)"]:::dev
    end

    subgraph "Build Toolchain"
        VITEDEV["Vite Dev Server"]:::build
        VITEBUILD["Vite Build (bundle static assets)"]:::build
        VITECONFIG["vite.config.ts"]:::build
        TSCONFIG["tsconfig.json"]:::build
        POSTCSS["postcss.config.js"]:::build
        TAILWIND["tailwind.config.ts"]:::build
        PUBLIC["Public Static Assets (public/)"]:::build
    end

    subgraph "Source Code"
        MAIN["Application Bootstrap (src/main.tsx)"]:::code
        APP["Root App Component & Routing (src/App.tsx)"]:::code
        GLOBALCSS["Global Styles (src/index.css & src/App.css)"]:::code
        subgraph "Page Entry Points"
            IDX["Index.tsx"]:::code
            NF["NotFound.tsx"]:::code
        end
        COMPONENTS["Page-Specific Components (src/components/)"]:::code
        UI["UI Primitives (src/components/ui/)"]:::code
        subgraph "Shared Hooks & Logic"
            SH1["use-mobile.tsx"]:::code
            SH2["use-toast.ts"]:::code
            SH3["utils.ts"]:::code
        end
    end

    subgraph "Deployment"
        DEPLOY["Deploy Script (gh-pages)"]:::build
        HOST["GitHub Pages (CDN)"]:::host
    end

    ENDUSER["End-User Browser"]:::browser

    DEV --> REPO
    REPO --> VITEDEV
    VITEDEV --> ENDUSER
    REPO --> VITEBUILD
    VITEBUILD --> DEPLOY
    DEPLOY --> HOST
    HOST --> ENDUSER

    VITEBUILD --> VITECONFIG
    VITEBUILD --> TSCONFIG
    VITEBUILD --> POSTCSS
    VITEBUILD --> TAILWIND
    VITEBUILD --> PUBLIC

    MAIN --> VITEBUILD
    APP --> VITEBUILD
    GLOBALCSS --> VITEBUILD
    IDX --> VITEBUILD
    NF --> VITEBUILD
    COMPONENTS --> VITEBUILD
    UI --> VITEBUILD
    SH1 --> VITEBUILD
    SH2 --> VITEBUILD
    SH3 --> VITEBUILD

    click REPO "https://github.com/ras-bmsit/sop25/tree/main/./"
    click DEV "https://github.com/ras-bmsit/sop25/blob/main/package.json"
    click VITECONFIG "https://github.com/ras-bmsit/sop25/blob/main/vite.config.ts"
    click TSCONFIG "https://github.com/ras-bmsit/sop25/blob/main/tsconfig.json"
    click POSTCSS "https://github.com/ras-bmsit/sop25/blob/main/postcss.config.js"
    click TAILWIND "https://github.com/ras-bmsit/sop25/blob/main/tailwind.config.ts"
    click PUBLIC "https://github.com/ras-bmsit/sop25/tree/main/public/"
    click MAIN "https://github.com/ras-bmsit/sop25/blob/main/src/main.tsx"
    click APP "https://github.com/ras-bmsit/sop25/blob/main/src/App.tsx"
    click GLOBALCSS "https://github.com/ras-bmsit/sop25/blob/main/src/index.css"
    click IDX "https://github.com/ras-bmsit/sop25/blob/main/src/pages/Index.tsx"
    click NF "https://github.com/ras-bmsit/sop25/blob/main/src/pages/NotFound.tsx"
    click COMPONENTS "https://github.com/ras-bmsit/sop25/tree/main/src/components/"
    click UI "https://github.com/ras-bmsit/sop25/tree/main/src/components/ui/"
    click SH1 "https://github.com/ras-bmsit/sop25/blob/main/src/hooks/use-mobile.tsx"
    click SH2 "https://github.com/ras-bmsit/sop25/blob/main/src/hooks/use-toast.ts"
    click SH3 "https://github.com/ras-bmsit/sop25/blob/main/src/lib/utils.ts"
    click DEPLOY "https://github.com/ras-bmsit/sop25/blob/main/package.json"

    classDef dev fill:#e0f7e9,stroke:#2e7d32,color:#1b5e20
    classDef build fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
    classDef host fill:#fff3e0,stroke:#ef6c00,color:#e65100
    classDef browser fill:#eceff1,stroke:#607d8b,color:#37474f
    classDef code fill:#f3e5f5,stroke:#6a1b9a,color:#4a148c
```
