# smitronix/personal-project architecture

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

- Interactive diagram: https://gitdiagram.com/smitronix/personal-project
- Repository: https://github.com/smitronix/personal-project

## Overview

This repository is a collection of mostly independent personal projects rather than one integrated application. The main architectural boundary is the folder level: each subdirectory is its own self-contained app, demo, or lab, with no clear shared runtime or cross-project code reuse.

1. Repository-level structure  
   The repo contains several standalone front-end apps, one React/Vite desktop-shell app, one PHP form system, one Node-based JSON manager, and one C lab artifact. For an architecture diagram, treat each top-level project as a separate system.

2. BWP-2: the most layered front-end project  
   `BWP-2` is a multi-page static web project with HTML entry points, shared CSS, client-side JavaScript, image assets, and an XML/XSD/XSL trio. It appears to be the most architecturally rich repo in the set.

3. BWP-2 presentation flow  
   Pages such as `index.html`, `auth.html`, `advanced-3d.html`, `hand-3d-live.html`, and `walkman-loop.html` load shared and page-specific styles from `css/` and behaviors from `js/`. This is a browser-only application boundary: rendering and interaction happen entirely client-side.

4. BWP-2 functional areas  
   The JS files are split by feature: `auth.js` for authentication UI, `advanced-3d.js` and `hand-3d-live.js` for 3D/animation experiences, and `walkman-loop.js` for another animation page. `css/style.css` plus specialized styles support those views. The project is organized by experience rather than by backend domain.

5. BWP-2 XML documentation/data layer  
   `xml/dfds.xml`, `dfds.xsd`, and `dfds.xsl` form a separate structured-document pipeline: XML content, schema validation, and XSL transformation. This suggests an internal documentation or diagram artifact flow distinct from the front-end pages.

6. Nexus OS: React desktop environment  
   `nexus-os` is a Vite-based React application that simulates a desktop OS UI. Its architecture is component-driven: `App.jsx` composes `Desktop`, `Taskbar`, `StartMenu`, `Window`, `ContextMenu`, `Notifications`, `BootScreen`, and `DesktopIcon`, with app modules under `components/apps/`.

7. Nexus OS state and UI orchestration  
   Shared application state lives in `src/core/store.js`, which likely coordinates windows, app launch, taskbar state, notifications, and desktop interactions. `main.jsx` bootstraps the React tree, and `src/styles/index.css` provides the global shell styling. This is a pure client-side SPA with no visible backend dependency.

8. Nexus OS embedded apps  
   The “Browser” and “Settings” components under `components/apps/` are windowed apps hosted inside the desktop shell. The architecture boundary here is important: the OS shell manages windowing and global state, while each app is a child module rendered inside a generic window container.

9. Simple static front-end projects  
   `e-commerce`, `user-registration-portal`, and `js-task-dashboard` are lightweight browser apps built from HTML/CSS/JS. They follow the classic static pattern: single-page UI, client-side interaction, and no explicit server layer in the repo.

10. PHP registration system  
   `php-registration-system` is a small server-rendered or server-handled form app. `index.php` is the entry point, `style.css` handles presentation, and `registrations.json` is the persistence store. The key architectural flow is browser form submission into PHP, then file-based JSON storage.

11. Node JSON manager  
   `json-manager-node` is a Node.js utility/service centered on `index.js` and `database.json`. Its architecture is file-backed JSON manipulation rather than a database server, making the file system the persistence boundary.

12. Demo and lab artifacts  
   `js-basics-demo` and `js-task-dashboard` are instructional browser demos. `C-Lab/if-else.c` and `if-else.exe` are a compiled C exercise, separate from the web stack. These should be treated as isolated learning modules, not subsystems of the larger apps.

13. Cross-cutting pattern across the repo  
   Most projects are self-contained and use local assets plus client-side logic, with persistence only in a few cases (`registrations.json`, `database.json`, XML docs). The repository has no shared service layer, API gateway, or common library layer tying the projects together.

14. Diagramming implication  
   If you draw an architecture diagram, model the repo as a portfolio of independent systems grouped by technology: static browser apps, a React desktop shell, a PHP file-backed form system, a Node JSON utility, and a C lab artifact. The strongest internal subsystem detail exists in `BWP-2` and `nexus-os`.

Main entry points: [`BWP-2`](https://github.com/smitronix/personal-project/tree/main/BWP-2) (BWP-2), [`nexus-os`](https://github.com/smitronix/personal-project/tree/main/nexus-os) (nexus-os), [`e-commerce/index.html`](https://github.com/smitronix/personal-project/blob/main/e-commerce/index.html) (Static apps), [`BWP-2/index.html`](https://github.com/smitronix/personal-project/blob/main/BWP-2/index.html) (Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_static["Static browser apps"]
  node_static_apps["Static apps<br/>browser demos<br/>[index.html]"]
  node_ecommerce["e-commerce<br/>static site<br/>[index.html]"]
  node_user_portal["Reg portal<br/>static form ui<br/>[index.html]"]
  node_js_dashboard["Task dashboard<br/>static dashboard<br/>[index.html]"]
end

subgraph group_group_bwp2["BWP-2"]
  node_bwp2_site["BWP-2<br/>static web app"]
  node_bwp2_pages["Pages<br/>html entry points<br/>[index.html]"]
  node_bwp2_styles["Styles<br/>css layer<br/>[style.css]"]
  node_bwp2_scripts["Scripts<br/>client js<br/>[auth.js]"]
  node_bwp2_assets[("Assets<br/>images")]
  node_bwp2_xml["XML flow<br/>xml/xsd/xsl<br/>[dfds.xml]"]
end

subgraph group_group_nexus["nexus-os"]
  node_nexus_os["nexus-os<br/>react desktop shell"]
  node_nexus_boot["Boot<br/>startup screen<br/>[BootScreen.jsx]"]
  node_nexus_desktop["Desktop UI<br/>shell components<br/>[Desktop.jsx]"]
  node_nexus_store[("Store<br/>ui state<br/>[store.js]")]
  node_nexus_apps["Apps<br/>[Browser.jsx]"]
end

subgraph group_group_server["Backend utilities"]
  node_php_reg["PHP system<br/>php form app<br/>[index.php]"]
  node_json_mgr["JSON manager<br/>node utility<br/>[index.js]"]
end

subgraph group_group_lab["Lab artifacts"]
  node_c_lab["C lab<br/>c exercise<br/>[if-else.c]"]
end

node_repo["personal-project<br/>portfolio repo"]

node_repo -->|"contains"| node_bwp2_site
node_repo -->|"contains"| node_nexus_os
node_repo -->|"contains"| node_static_apps
node_repo -->|"contains"| node_php_reg
node_repo -->|"contains"| node_json_mgr
node_repo -->|"contains"| node_c_lab
node_bwp2_site -->|"serves"| node_bwp2_pages
node_bwp2_site -->|"styles with"| node_bwp2_styles
node_bwp2_site -->|"behaves with"| node_bwp2_scripts
node_bwp2_site -.->|"uses"| node_bwp2_assets
node_bwp2_site -->|"documents"| node_bwp2_xml
node_bwp2_pages -.->|"loads"| node_bwp2_styles
node_bwp2_pages -.->|"loads"| node_bwp2_scripts
node_bwp2_pages -.->|"references"| node_bwp2_assets
node_bwp2_xml -.->|"transforms with"| node_bwp2_styles
node_nexus_os -->|"starts with"| node_nexus_boot
node_nexus_os -->|"renders"| node_nexus_desktop
node_nexus_os -->|"coordinates via"| node_nexus_store
node_nexus_os -->|"hosts"| node_nexus_apps
node_nexus_desktop -.->|"reads/writes"| node_nexus_store
node_nexus_desktop -.->|"opens"| node_nexus_apps
node_static_apps -->|"includes"| node_ecommerce
node_static_apps -->|"includes"| node_user_portal
node_static_apps -->|"includes"| node_js_dashboard
node_php_reg -.->|"uses file storage pattern"| node_json_mgr

click node_bwp2_site "https://github.com/smitronix/personal-project/tree/main/BWP-2"
click node_bwp2_pages "https://github.com/smitronix/personal-project/blob/main/BWP-2/index.html"
click node_bwp2_styles "https://github.com/smitronix/personal-project/blob/main/BWP-2/css/style.css"
click node_bwp2_scripts "https://github.com/smitronix/personal-project/blob/main/BWP-2/js/auth.js"
click node_bwp2_assets "https://github.com/smitronix/personal-project/tree/main/BWP-2/assets/images"
click node_bwp2_xml "https://github.com/smitronix/personal-project/blob/main/BWP-2/xml/dfds.xml"
click node_nexus_os "https://github.com/smitronix/personal-project/tree/main/nexus-os"
click node_nexus_boot "https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/BootScreen.jsx"
click node_nexus_desktop "https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/Desktop.jsx"
click node_nexus_store "https://github.com/smitronix/personal-project/blob/main/nexus-os/src/core/store.js"
click node_nexus_apps "https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/apps/Browser.jsx"
click node_static_apps "https://github.com/smitronix/personal-project/blob/main/e-commerce/index.html"
click node_ecommerce "https://github.com/smitronix/personal-project/blob/main/e-commerce/index.html"
click node_user_portal "https://github.com/smitronix/personal-project/blob/main/user-registration-portal/index.html"
click node_js_dashboard "https://github.com/smitronix/personal-project/blob/main/js-task-dashboard/index.html"
click node_php_reg "https://github.com/smitronix/personal-project/blob/main/php-registration-system/index.php"
click node_json_mgr "https://github.com/smitronix/personal-project/blob/main/json-manager-node/index.js"
click node_c_lab "https://github.com/smitronix/personal-project/blob/main/C-Lab/if-else.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_static_apps,node_ecommerce,node_user_portal,node_js_dashboard toneBlue
class node_bwp2_site,node_bwp2_pages,node_bwp2_styles,node_bwp2_scripts,node_bwp2_assets,node_bwp2_xml toneAmber
class node_nexus_os,node_nexus_boot,node_nexus_desktop,node_nexus_store,node_nexus_apps toneMint
class node_php_reg,node_json_mgr toneRose
class node_c_lab toneIndigo
class node_repo toneNeutral
```

## Components

### Static browser apps

Independent client-side web projects with HTML/CSS/JS.

- [Static apps](https://github.com/smitronix/personal-project/blob/main/e-commerce/index.html): browser demos · Lightweight standalone HTML/CSS/JS projects such as e-commerce, registration portal, and task dashboard. · `e-commerce/index.html`
- [e-commerce](https://github.com/smitronix/personal-project/blob/main/e-commerce/index.html): static site · Simple browser front-end with local scripting and styling. · `e-commerce/index.html`
- [Reg portal](https://github.com/smitronix/personal-project/blob/main/user-registration-portal/index.html): static form ui · Client-side registration portal with HTML, script, and style assets. · `user-registration-portal/index.html`
- [Task dashboard](https://github.com/smitronix/personal-project/blob/main/js-task-dashboard/index.html): static dashboard · Instructional browser dashboard built from local HTML/CSS/JS. · `js-task-dashboard/index.html`

### BWP-2

Most layered static web project with page, asset, and XML document flows.

- [BWP-2](https://github.com/smitronix/personal-project/tree/main/BWP-2): static web app · Multi-page browser-only experience with shared styles, page scripts, assets, and an XML/XSD/XSL documentation pipeline. · `BWP-2`
- [Pages](https://github.com/smitronix/personal-project/blob/main/BWP-2/index.html): html entry points · Main and feature pages such as index, auth, and 3D/animation views. · `BWP-2/index.html`
- [Styles](https://github.com/smitronix/personal-project/blob/main/BWP-2/css/style.css): css layer · Shared and page-specific presentation rules for the BWP-2 experiences. · `BWP-2/css/style.css`
- [Scripts](https://github.com/smitronix/personal-project/blob/main/BWP-2/js/auth.js): client js · Feature-oriented browser logic for auth, 3D, and animation pages. · `BWP-2/js/auth.js`
- [Assets](https://github.com/smitronix/personal-project/tree/main/BWP-2/assets/images): images · Local image assets consumed by the BWP-2 pages. · `BWP-2/assets/images`
- [XML flow](https://github.com/smitronix/personal-project/blob/main/BWP-2/xml/dfds.xml): xml/xsd/xsl · Structured-document pipeline for XML content, schema validation, and transformation. · `BWP-2/xml/dfds.xml`

### nexus-os

React desktop-shell application with windowed child apps and shared UI state.

- [nexus-os](https://github.com/smitronix/personal-project/tree/main/nexus-os): react desktop shell · Vite-based React desktop environment with window management, taskbar, notifications, and embedded apps. · `nexus-os`
- [Boot](https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/BootScreen.jsx): startup screen · Initial boot/loading experience for the desktop shell. · `nexus-os/src/components/BootScreen.jsx`
- [Desktop UI](https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/Desktop.jsx): shell components · Core desktop surface and chrome: desktop, taskbar, start menu, window, context menu, notifications, and icons. · `nexus-os/src/components/Desktop.jsx`
- [Store](https://github.com/smitronix/personal-project/blob/main/nexus-os/src/core/store.js): ui state · Shared client-side state coordinating windows, app launch, and desktop interactions. · `nexus-os/src/core/store.js`
- [Apps](https://github.com/smitronix/personal-project/blob/main/nexus-os/src/components/apps/Browser.jsx): windowed apps · Embedded desktop apps hosted inside the generic window container. · `nexus-os/src/components/apps/Browser.jsx`

### Backend utilities

File-backed or server-handled projects outside the browser-only apps.

- [PHP system](https://github.com/smitronix/personal-project/blob/main/php-registration-system/index.php): php form app · Server-handled registration flow persisting submissions to a JSON file. · `php-registration-system/index.php`
- [JSON manager](https://github.com/smitronix/personal-project/blob/main/json-manager-node/index.js): node utility · Node.js file-backed JSON tool centered on database.json and index.js. · `json-manager-node/index.js`

### Lab artifacts

Standalone compiled or instructional exercises.

- [C lab](https://github.com/smitronix/personal-project/blob/main/C-Lab/if-else.c): c exercise · Standalone compiled C practice artifact and source file. · `C-Lab/if-else.c`

### Other components

- **personal-project**: portfolio repo · A collection of mostly independent personal projects with no shared runtime or common application layer.

## Connections

- personal-project → BWP-2: contains · Top-level project folder
- personal-project → nexus-os: contains · Top-level project folder
- personal-project → Static apps: contains · Top-level project folders
- personal-project → PHP system: contains · Top-level project folder
- personal-project → JSON manager: contains · Top-level project folder
- personal-project → C lab: contains · Top-level project folder
- BWP-2 → Pages: serves · HTML entry points drive the browser experiences
- BWP-2 → Styles: styles with · Shared and page-specific CSS
- BWP-2 → Scripts: behaves with · Client-side interaction logic
- BWP-2 → Assets: uses · Local image assets
- BWP-2 → XML flow: documents · Separate XML schema/transformation pipeline
- Pages → Styles: loads · Pages pull in CSS
- Pages → Scripts: loads · Pages pull in JS
- Pages → Assets: references · Pages embed local images
- XML flow → Styles: transforms with · XSL is part of the document workflow
- nexus-os → Boot: starts with · Boot/loading phase before the desktop shell
- nexus-os → Desktop UI: renders · Main shell and chrome
- nexus-os → Store: coordinates via · Shared UI state and window lifecycle
- nexus-os → Apps: hosts · Embedded apps inside the desktop container
- Desktop UI → Store: reads/writes · Desktop interactions and global state
- Desktop UI → Apps: opens · Windows render child apps
- Static apps → e-commerce: includes · Standalone browser app
- Static apps → Reg portal: includes · Standalone browser app
- Static apps → Task dashboard: includes · Standalone browser app
- PHP system → JSON manager: uses file storage pattern · Both persist state in local JSON files, but remain independent
