# blueedgetechno/win11react architecture

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

- Interactive diagram: https://gitdiagram.com/blueedgetechno/win11react
- Repository: https://github.com/blueedgetechno/win11react

## Overview

##### Project type and purpose
- This is a single‐page application (SPA) built in React+Redux that mimics the Windows 11 desktop experience in a browser or as a desktop app via Tauri.
- It’s a PWA (manifest, service worker) and also packaged into a native desktop application using Tauri (Rust backend).

##### File structure
- Top level:
- public/ – static assets (HTML, CSS, JS, images, PWA manifest, service worker)
- src/ – React application (components, containers, actions, reducers, utils)
- src-tauri/ – Rust/Tauri code for native desktop wrapper (main.rs, build.rs, configuration)
- Configuration files: package.json, vite.config.js, tailwind.config.js, .firebaserc, crowdin.yml (CI/CD, localization), GitHub Actions, Dockerfiles, Procfile for Heroku

##### Key architecture notes from README
- No backend API: purely front‐end logic, state managed with Redux
- Optional hosting on static servers (Netlify, Vercel, Docker, Heroku)
- Localization managed with Crowdin and i18next
- PWA features for offline support (serviceWorker.js)
- Desktop native features via Tauri

##### Main components and their interactions
a. Browser / Desktop Shell (Tauri)
- Hosts the React SPA in a WebView (Tauri’s window)
- Exposes native APIs (filesystem, settings) to JS via Tauri bridge
b. React + Redux SPA
- UI Components (src/components)
- Containers/Pages (src/containers)
- State Management (src/actions ↔ src/reducers)
- Styling: SCSS, CSS modules, Tailwind
c. Static Asset Server / CDN
- Serves public/index.html, JS bundles, CSS, images
- PWA manifest and service worker for caching
d. CI/CD & Localization
- GitHub Actions for build & deploy
- Crowdin for translation sync
e. Deployment environments (optional microservices)
- Docker container, Heroku, Netlify, Vercel, Firebase hosting

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Tier
    subgraph "Client Tier"
        Browser["Browser"]:::client
        Tauri["Tauri WebView"]:::client
        SW["Service Worker / PWA Cache"]:::client
    end

    %% Presentation Tier
    subgraph "Presentation Tier"
        Entry["React SPA Entry Point"]:::presentation
        Components["React Components"]:::presentation
        Containers["React Containers/Pages"]:::presentation
        ServiceReg["Service Worker Registration"]:::presentation
    end

    %% Data/State Tier
    subgraph "Data/State Tier"
        Actions["Redux Actions"]:::state
        Reducers["Redux Reducers"]:::state
        Store["Redux Store"]:::state
    end

    %% Infrastructure Tier
    subgraph "Infrastructure Tier"
        StaticServer["Static Asset Server (CDN/Heroku/Netlify)"]:::infra
        HTML["public/index.html"]:::infra
        Assets["Static Assets (public/)"]:::infra
        ManifestFile["public/manifest.json"]:::infra
        ServiceWorkerFile["public/serviceWorker.js"]:::infra
        Locales["public/locales/"]:::infra
        Crowdin["Crowdin Service"]:::infra
        CrowdinYml["crowdin.yml"]:::infra
        GitHubCI["GitHub Actions CI/CD"]:::infra
        Deploy["Deployment Targets"]:::infra
        Procfile["Procfile"]:::infra
        FirebaseConf[".firebaserc"]:::infra
        ViteConfig["vite.config.js"]:::infra
        TailwindConfig["tailwind.config.js"]:::infra
        TauriConf["src-tauri/tauri.conf.json"]:::infra
        BuildScript["src-tauri/build.rs"]:::infra
    end

    %% Connections
    Browser --> Tauri
    Browser -->|"intercept network"| SW
    Entry --> Components
    Entry --> Containers
    Entry --> ServiceReg
    Containers --> Components
    Components -->|"dispatch actions"| Actions
    Actions --> Reducers
    Reducers --> Store
    Store --> Components
    ServiceReg --> SW
    Browser --> ManifestFile
    SW --> ServiceWorkerFile
    Tauri <-->|"Tauri Bridge (native APIs)"| Entry
    StaticServer --> Entry
    StaticServer --> HTML
    StaticServer --> Assets
    GitHubCI --> StaticServer
    CrowdinYml --> Crowdin
    Crowdin --> Locales
    ViteConfig --> GitHubCI
    TailwindConfig --> GitHubCI
    GitHubCI --> Deploy
    Procfile --> Deploy
    FirebaseConf --> Deploy
    TauriConf --> Tauri
    BuildScript --> Tauri

    %% Click Events
    click Tauri "https://github.com/blueedgetechno/win11react/blob/master/src-tauri/src/main.rs"
    click TauriConf "https://github.com/blueedgetechno/win11react/blob/master/src-tauri/tauri.conf.json"
    click BuildScript "https://github.com/blueedgetechno/win11react/blob/master/src-tauri/build.rs"
    click Entry "https://github.com/blueedgetechno/win11react/blob/master/src/index.jsx"
    click Components "https://github.com/blueedgetechno/win11react/tree/master/src/components/"
    click Containers "https://github.com/blueedgetechno/win11react/tree/master/src/containers/"
    click Actions "https://github.com/blueedgetechno/win11react/blob/master/src/actions/index.js"
    click Reducers "https://github.com/blueedgetechno/win11react/blob/master/src/reducers/index.js"
    click ManifestFile "https://github.com/blueedgetechno/win11react/blob/master/public/manifest.json"
    click ServiceWorkerFile "https://github.com/blueedgetechno/win11react/blob/master/public/serviceWorker.js"
    click ServiceReg "https://github.com/blueedgetechno/win11react/blob/master/src/serviceWorkerRegistration.js.bak"
    click HTML "https://github.com/blueedgetechno/win11react/blob/master/public/index.html"
    click Assets "https://github.com/blueedgetechno/win11react/tree/master/public/"
    click Locales "https://github.com/blueedgetechno/win11react/tree/master/public/locales/"
    click CrowdinYml "https://github.com/blueedgetechno/win11react/blob/master/crowdin.yml"
    click GitHubCI "https://github.com/blueedgetechno/win11react/tree/master/.github/workflows/"
    click Procfile "https://github.com/blueedgetechno/win11react/tree/master/Procfile"
    click FirebaseConf "https://github.com/blueedgetechno/win11react/blob/master/.firebaserc"
    click ViteConfig "https://github.com/blueedgetechno/win11react/blob/master/vite.config.js"
    click TailwindConfig "https://github.com/blueedgetechno/win11react/blob/master/tailwind.config.js"

    %% Styles
    classDef client fill:#BBDEFB,stroke:#000,stroke-width:1px
    classDef presentation fill:#C8E6C9,stroke:#000,stroke-width:1px
    classDef state fill:#FFF9C4,stroke:#000,stroke-width:1px
    classDef infra fill:#E0E0E0,stroke:#000,stroke-width:1px
```
