# bharath6911/share-anything architecture

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

- Interactive diagram: https://gitdiagram.com/bharath6911/share-anything
- Repository: https://github.com/bharath6911/share-anything

## Overview

##### Project type and purpose
- Share‑Anything is a full‑stack, real‑time file and text sharing web application.
- Front‑end: static HTML/CSS/JavaScript pages (PWA enabled via a service worker).
- Back‑end: Node.js/Express server handling HTTP file/text APIs and WebSocket (real‑time) events.
- Persistence: MongoDB for metadata; Cloudinary for file storage.
- Deployed on Render.com.

##### File structure
- Top‑level:
- server.js – entry point (Express + WebSocket initialization).
- .env – credentials for MongoDB, Cloudinary.
- sw.js (root) – service‑worker registration for caching/real‑time events.
- public/ – static assets served to browser: index.html, css.css, js.js, sw.js, Manifest.json.
- routes/upload.js – Express route handling file uploads via Multer + Cloudinary storage.
- models/File.js – Mongoose schema for storing file/text metadata.
- uploads/ – local temp folder for Multer (if used), although primary storage is Cloudinary.
- package.json – dependencies (express, mongoose, multer, multer-storage-cloudinary, socket.io, etc.).

##### README for additional insights
- Real‑time communication in “rooms” (up to 10 participants) uses WebSockets.
- File uploads are offloaded to Cloudinary via Multer‑Storage‑Cloudinary.
- MongoDB stores metadata (file URLs, text messages, room assignments).
- PWA features: sw.js, Manifest.json.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Front-end (Browser)" 
        direction TB
        FC["Browser Client"]:::client
        SW["Service Worker"]:::client
        PM["PWA Manifest"]:::client

        FC -->|"Registers SW"| SW
        FC -->|"Loads Manifest"| PM
    end

    subgraph "Back-end (Render.com)"
        direction TB
        SERV["Node.js/Express App"]:::server
        REST["Express REST API<br>(routes/upload.js)"]:::server
        WS["WebSocket Engine<br>(socket.io handlers)"]:::server
        TEMP["Temp Storage<br>(uploads/)"]:::db
        ENV["Environment Config<br>(.env)"]:::server
        PKG["Dependencies<br>(package.json)"]:::server

        SERV --> REST
        SERV --> WS
        REST -->|"Uses Multer"| TEMP
    end

    FC -->|"HTTP GET static assets"| SERV
    FC -->|"HTTP POST upload/text"| REST
    FC -->|"WebSocket (wss://)"| WS

    REST -->|"stores files via"| CLD["Cloudinary"]:::ext
    SERV -->|"writes metadata"| MDB["MongoDB Atlas"]:::db
    SERV -->|"uses schema"| FileModel["File Model"]:::db
    WS -->|"broadcasts events"| FC

    click FC "https://github.com/bharath6911/share-anything/blob/main/public/index.html"
    click FC "https://github.com/bharath6911/share-anything/blob/main/public/css.css"
    click FC "https://github.com/bharath6911/share-anything/blob/main/public/js.js"
    click SW "https://github.com/bharath6911/share-anything/blob/main/public/sw.js"
    click SW "https://github.com/bharath6911/share-anything/blob/main/sw.js"
    click PM "https://github.com/bharath6911/share-anything/blob/main/public/Manifest.json"
    click SERV "https://github.com/bharath6911/share-anything/blob/main/server.js"
    click REST "https://github.com/bharath6911/share-anything/blob/main/routes/upload.js"
    click WS "https://github.com/bharath6911/share-anything/blob/main/server.js"
    click TEMP "https://github.com/bharath6911/share-anything/tree/main/uploads/"
    click ENV "https://github.com/bharath6911/share-anything/blob/main/.env"
    click PKG "https://github.com/bharath6911/share-anything/blob/main/package.json"
    click FileModel "https://github.com/bharath6911/share-anything/blob/main/models/File.js"

    classDef client fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef server fill:#D0FFD0,stroke:#333,stroke-width:1px
    classDef db fill:#E8D0FF,stroke:#333,stroke-width:1px
    classDef ext fill:#FFE0B2,stroke:#333,stroke-width:1px
```
