Merge branch 'main' of https://github.com/Haris16-code/BJH-OS

Author: Haris16-code

.github/workflows/sf-mirror.yml

@@ -0,0 +1,36 @@
+name: Mirror to SourceForge
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+
+    steps:
+      # Checkout GitHub repo with full history
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0  # important! fetch all commits
+
+      # Set up SSH
+      - name: Set up SSH
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.SF_PRIVATE_KEY }}" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          ssh-keyscan -t rsa git.code.sf.net >> ~/.ssh/known_hosts
+
+      # Add SourceForge remote
+      - name: Add SourceForge remote
+        run: git remote add sourceforge "ssh://[email protected]/p/bjh-os/code"
+
+      # Push all branches and tags
+      - name: Push to SourceForge
+        run: |
+          git push sourceforge --all
+          git push sourceforge --tags

DEV_DOCS.md

@@ -1300,4 +1300,4 @@ This project is not affiliated with Microsoft or Windows. It is an Web Based Ope
 ---
 **End of Developer Documentation**
 
-For questions, issues, or contributions, please contact us on [Discord](https://discord.gg/SdDSUtCbX8)
+For questions, issues, or contributions, please contact us on [Discord](https://discord.gg/SdDSUtCbX8)

README.md

@@ -0,0 +1,210 @@
+# 💻 BJH OS
+
+Assalam O Alaikum everyone! 👋 My name is **Muhammad Haris** and I made a **web-based operating system** named **BJH OS** 🌐💡
+
+**BJH OS** is a **browser-based operating system** developed using **pure HTML, CSS, and JavaScript** — no frameworks, no backend dependencies ⚙️🚫. It’s designed to give you the feel of a real desktop OS, but in your web browser 🖥️✨
+
+---
+
+## 🚀 Key Features
+
+- 🖼️ **Custom Desktop Environment**  
+  Draggable, resizable windows with a familiar desktop layout. Apps now open inside movable, desktop-style windows with titlebars and close buttons. Windows can be maximized or restored by double-clicking the titlebar.
+- 🖱️ **Smoother UI & Window Management**  
+  Enhanced shadows, borders, and polished drag interactions give a modern desktop feel. Double-click the titlebar to maximize/restore windows, and enjoy smoother dragging and window interactions.
+
+- 📦 **Built-in Apps**  
+  Includes File Manager, Notes, Chat App (*ChatLink*), Settings, and more. Start menu & toolbar apps now open inside windows instead of new tabs, providing a seamless desktop experience.
+
+- 🧩 **Modular Architecture**  
+  Easily add new themes, wallpapers, and apps.
+
+- 💾 **Persistent Data**  
+  Uses `localStorage` to save your preferences and data between sessions.
+
+- 🧑‍💻 **Powerful Web Terminal**  
+  Run commands and control the OS with a built-in terminal — ideal for devs and power users.
+
+- 🌐 **Remote Alerts & Update System**  
+  Displays alerts and updates fetched from a remote JSON config. Automatic notifications ensure you never miss an important update.
+
+- 🤖 **BJH OS AI**  
+  Built-in assistant for smarter interactions and workflow automation.
+
+- 🌐 **Flash Browser**  
+  Lightweight, fast, and secure browser integrated into BJH OS.
+  
+- 🌍 **Worldwide Rollout**  
+  Updates are being released globally in stages to ensure stability, avoid server overload, and provide a smooth installation experience.
+
+
+
+
+### 🎉 BJH OS Apps Market
+
+The **BJH OS Apps Market** is included in the **BJH OS 4.7 update** and is released in phases to ensure smooth performance and prevent server overload.
+
+---
+
+### ✨ Main Features
+
+- Browse all apps and games with a **search bar** and **autocomplete suggestions**.  
+- Tabs for **Games**, **Apps**, and **Search**.  
+- App display includes: **icon, name, category, rating, and number of downloads**.  
+- Trending notifications at the top with app URL and main image.  
+- App detail page shows:  
+  - Icon & name  
+  - Developer/company name  
+  - Rating and number of reviews  
+  - Download size and number of downloads  
+  - Download button  
+  - Screenshots and video previews  
+  - About this app/game description  
+  - Ratings & Reviews with “Was this review helpful?” counters  
+  - Similar apps or games at the bottom  
+
+---
+
+### 👤 User Features
+
+- **Login or create a BJH OS account** to use the Apps Market.  
+- Manage favorite apps.  
+- Downloads saved in **Manage Apps** panel.  
+- **Download the latest apps and games**.  
+- **Update apps automatically** when a new version is available.  
+- Rate and review apps.  
+- Reset or recover forgotten passwords.  
+- Receive system and email notifications for registration and app updates.  
+
+---
+
+### 💻 Developer Features
+
+- Upload apps/games with: icon, name, description, screenshots/video, category, version, and zip file.  
+- Upload updates for existing apps.  
+- View app statistics: downloads, ratings, reviews.  
+- Comment on user reviews.  
+- Manage promotion points for app visibility.  
+- Notifications panel for approvals and promotion updates.  
+- Provide app support info: website, email.  
+- Submit appeals if needed.  
+
+---
+
+### 🔒 Security & UX
+
+- Secure login for users and developers (password hashing, reset password).  
+- Validation for file uploads (icons, videos, zip files).  
+- Modern, beautiful, mobile-friendly UI.  
+- Clear and intuitive navigation.  
+
+---
+
+### 🌟 Extra Features
+
+- Rating aggregation and visualization.  
+- Review helpfulness tracking.  
+- Trending apps notifications.  
+- Smooth app promotion workflow with points system.  
+- System emails for registration, app updates, and promotions.  
+
+---
+
+### 📢 Rollout Updates
+
+- Introduced in **BJH OS 4.7 update**.  
+- Released in **phases** to reduce server overload and prevent crashes.  
+- Users gradually gain access as the rollout progresses.  
+- Updates and notifications sent via **BJH OS system notifications** and emails.  
+
+---
+
+## 🛠️ How to Run BJH OS
+
+1. ⬇️ **Download the ZIP** from the [BJH OS MAIN REPOSITORY](https://github.com/Haris16-code/BJH-OS)  
+2. 🗂️ **Extract** the ZIP file  
+3. Open the extracted `BJH-OS` folder  
+4. 🖱️ **Double-click** the file named `Setup.html`  
+5. 🌍 BJH OS will launch in your default browser  
+
+> 🧑‍💻 No installation required — just open and go!
+
+---
+
+## 🧰 BJH OS TOOL
+
+To make managing BJH OS easier, I developed a Python-based utility called **BJH OS TOOL** 🐍🛠️  
+It lets you:
+
+- 📦 Install BJH OS updates  
+- 🎮 Install apps and games  
+- 🖼️ Install wallpapers and cursors  
+
+### 🖥️ BJH OS TOOL 64-Bit
+
+- 🛠️ Install BJH OS Update: Extract the latest ZIP → Open BJH OS TOOL → Click "Install Update" → Select the extracted folder → Refresh BJH OS.  
+- 🖱️ Install Cursor: Select `.svg` file → Refresh BJH OS.  
+- 🖼️ Install Wallpaper: Select `.jpg` or `.png` image → Refresh BJH OS.  
+- 🎮 Install Apps/Games: Select the app folder → Open from BJH OS home screen.
+
+### 🖥️ BJH OS TOOL 32-Bit
+
+- ▶️ Run Tool: Double-click to start.  
+- 🛠️ Install Update: Provide the folder path for the update.  
+- 🎯 Install Cursor: Provide full path to `.svg` file.  
+- 🖼️ Install Wallpaper: Provide full path to image.  
+- 📦 Install App: Provide the directory path containing `index.html`.
+
+---
+
+## 📁 General Notes on File Paths
+
+- 🧭 **Absolute Path:** Full path from the root of the filesystem.  
+- 🧮 **Relative Path:** Path relative to your current directory.  
+
+**Examples:**  
+- Absolute: `C:\Users\YourName\Documents\myfile.jpg`  
+- Relative: `.\Documents\myfile.jpg`
+
+✅ Ensure the file or folder exists before proceeding.
+
+---
+## 🧑‍💻 Developer Documentation
+
+BJH OS 4.6 developer docs provide everything you need to **build, extend, and create apps or games** for the web-based desktop experience.  
+
+**Highlights:**
+- **Step-by-Step App & Game Development For BJH OS:** Learn how to create apps and games for BJH OS from scratch, including folder structure, required files, optional assets, and best practices.  
+- **Project Structure:** Clear layout of core files and directories:
+- **Window & Taskbar Systems:** Full guidance on draggable, resizable windows, maximize/restore behavior, taskbar icons, and in-window app launching.  
+- **App Models:** Supports both built-in apps (pre-installed) and 3rd-party apps (installed via BJH OS TOOL).  
+- **App Folder Template & Installer Flow:** Proper folder setup with required files (`index.html`, `favicon.ico`) and optional files (`style.css`, `app.js`, `constants.js`, assets). Includes installer instructions for seamless integration into BJH OS.  
+- **Font Sync & Theming:** Apps automatically inherit the system font using `localStorage.selectedFont`. Supports custom themes and styling.  
+- **Examples Included:** Ready-to-use apps like **Calculator** and **Snake** demonstrate best practices for structure, styling, and functionality.  
+- **API & Programmatic Launching:** Use `window.openAppInWindow(url, title)` for in-window app launches and intercept same-origin `window.open()` calls.  
+- **Testing & Troubleshooting:** Checklist for responsiveness, offline support, console errors, and common fixes. Tips for performance optimization and user experience.  
+- **Developer Guidance & Best Practices:** Code style, accessibility, packaging/sharing apps, contributor workflow, and submitting apps to the BJH OS ecosystem.  
+
+> For full instructions, examples, and detailed guidance:  
+> 📄 **[Full Developer Documentation Here](DEV_DOCS.md)**
+
+
+## 💻 BJH OS Discord Community
+
+Join the **BJH OS Community** on Discord and connect with fellow users, developers, and enthusiasts! 🎉  
+**[Join Now!](https://discord.gg/SdDSUtCbX8)**
+
+We are building an active community around **BJH OS**, where you can:
+
+- Get help with installation and troubleshooting  
+- Share feedback and suggestions  
+- Upload apps or games for the BJH OS Apps Market  
+- Chat with other BJH OS users and developers  
+- Participate in events, contests, and discussions
+
+Whether you are a **developer, tester, or BJH OS fan**, there’s a place for you here!
+
+---
+**Made with love in Pakistan ❤️**  
+---  
+**© 2025 BJH OS — by Muhammad Haris**