🎯 BJH OS — Free • Open‑Source • Web‑Based Operating System

Run a full desktop in your browser — build apps, publish to the Apps Market, and help shape the next web-native desktop.

✨ What is BJH OS?

BJH OS is a lightweight, fully client-side desktop environment built with plain HTML, CSS, and JavaScript — no backend required. It runs in any modern browser and aims to be:
- Instant: open a URL and you have a desktop.
- Extensible: anyone can build apps (index.html + assets).
- Community-driven: friendly to first-time contributors and experienced devs alike.

🎨 Visuals & Demo

🚀 Highlights at a glance

• 🖥️ Desktop UI — draggable & resizable windows, taskbar, start-like menu
• 📦 Apps — File Manager, Notes, ChatLink, Browser, Settings, Terminal
• 💾 Persistence — user data & preferences saved with localStorage
• 🛍️ Apps Market — one-click installs, staged updates, analytics & review
• ⚡ Fast — client-side UI, light assets, PWA-like behavior with manifest & service worker
• 🔒 Safe — admin-reviewed apps to keep the marketplace trustworthy

🧭 Quick start — Users

Try BJH OS in seconds:
- Live demo (open in browser): Launch BJH OS (Demo)
- Or run locally:
1. git clone https://github.com/Haris16-code/BJH-OS.git
2. cd BJH-OS
3. python -m http.server 8000 OR npx http-server -p 8000
4. Open http://localhost:8000 (or double-click index.html)

🛠️ Quick start — Developers & App Makers

• Developer docs: DEV_DOCS.md
• App Market guide: CONTRIBUTING_TO_BJH_OS_APPS_MARKET.md
• App template: A folder with index.html, manifest.json (recommended), favicon.ico, and screenshots.

Pro tip: use window.openAppInWindow(url, title) for in-window launching and ensure same-origin rules for best integration.

🛒 Apps Market — Why publish on BJH OS (short & compelling)

Publish your web app to BJH OS and reach users who treat web apps like desktop apps.

• 🔎 Focused discovery — your app appears in a curated desktop store
• ⚡ One‑click installs — instant use inside BJH OS, no downloads
• 🔄 Staged updates — zero downtime; users keep previous version until new one approved
• 🛡️ Human review — higher user trust and safer installs
• 📈 Analytics — see installs & 7‑day trends to measure impact
• 🗨️ Direct feedback — built-in ticketing to get user reports & improve fast
• ⭐ Promotion opportunities — featured slots, trending sections, hackathons

Publish steps:
1. Prepare app folder (index.html, screenshots, manifest.json)
2. Upload via Apps Market uploader or open a PR with your app folder
3. Get reviewed → staged release → live

Full guide: Apps Market guide

🙌 How you can help (high impact • low friction)

Contributions of any size move BJH OS forward — pick one:

Quick (5–30 min)
- ⭐ Star the repo — Star BJH OS
- 🐛 Report bugs — New issue
- 🐣 Try a "good first issue" — Good first issues

Small engineering (1–4 hours)
- 🔧 Fix bugs — Issues labeled bug
- ✨ Add features — Feature requests
- 🎨 Polish UI — improve icons, spacing, themes, or add wallpapers

Higher impact
- 🧩 Build & publish apps to the Apps Market
- 🌍 Translate UI strings and docs
- ♿ Improve accessibility and add tests
- 🔐 Perform security reviews or audits

PR Checklist (make it mergeable)
1. Fork → branch: git checkout -b feat/your-change
2. Keep commits focused and small
3. Link related issue and add screenshots/GIFs for UI changes
4. Run linters/tests if present and respond to reviews promptly

Contributing guide: CONTRIBUTING.md

🛡️ Security & reporting

If you find a security issue, follow: SECURITY.md

📣 Make BJH OS trending — Launch checklist

Before launch:
- Finalize README + demo GIF (this file!)
- Add 3–5 "good first issues" with clear steps
- Prepare release & CHANGELOG

Launch day (first 48 hours — momentum matters):
- Post to Product Hunt, Hacker News, r/webdev, r/opensource & Twitter/X
- Ask early contributors to star & share the repo
- Be active: respond to issues & PRs quickly

Social templates (copy & paste)
- Twitter/X:
"▶️ Try BJH OS — a desktop that runs in your browser. No installs. Demo: http://bjhos.me/BJH-OS/ ⭐ Fork & contribute: https://github.com/Haris16-code/BJH-OS #opensource #webdev"
- Hacker News:
Title: "BJH OS — A free, open-source desktop that runs in your browser (demo)"

📚 Resources

• Repo: https://github.com/Haris16-code/BJH-OS/ "Main repository"
• Live demo: http://bjhos.me/BJH-OS/ "Open BJH OS demo"
• Developer docs: https://github.com/Haris16-code/BJH-OS/blob/main/DEV_DOCS.md "Architecture & APIs"
• Apps Market guide: https://github.com/Haris16-code/BJH-OS/blob/main/CONTRIBUTING_TO_BJH_OS_APPS_MARKET.md "How to publish apps"
• Issues: https://github.com/Haris16-code/BJH-OS/issues "Report bugs & pick tasks"
• Discord: https://discord.gg/SdDSUtCbX8 "Join our community"

📝 License & credits

• License: AGPL‑3.0 — LICENSE
• Contributors: see CONTRIBUTORS.md

Made with ❤️ in Pakistan
© 2025 BJH OS — by Muhammad Haris (Haris16-code)