README.md

Status: 🚧 Frontend UI Simulation — Interactive web desktop interface. Advanced system architecture and features are currently under concept development.

📸 Preview Images

🎨 Main Interface

╔════════════════════════════════════════════════════════════════════════════╗
║                                                                            ║
║   Every shadow. Every translucent layer. Every kernel event.              ║
║   Designed to make the boundary between web and OS vanish.                ║
║   — Tcode-Motion  🌌                                                      ║
║                                                                            ║
║   "The screen is not a wall — it is a window into a deeper reality."      ║
║   "Code is the ink; the processor is the paper; the OS is the story."     ║
║   "Stability is not the absence of change, but the presence of flow."     ║
║   "The future of computing is the synthesis of art and logic."            ║
║                                                                            ║
╚════════════════════════════════════════════════════════════════════════════╝

📖 Table of Contents

• 🌌 The Vision
• 📦 Application Ecosystem
• 📋 Full Application Registry (v1.3.0)
• ⌨️ Global Hotkeys & Shell Reference
  • Global System Shortcuts
  • The novash Command Suite
  • Advanced Command Flags
• 🔐 Security, Identity & Authentication
• 🛠️ Core Developer Documentation
  • Project Structure
  • API Reference (window.kernel)
  • Adding a New App
• 🚀 Roadmap & Future Vistas
• 🕰️ Changelog
• ❓ Troubleshooting & FAQ
• 📚 System Glossary
• 📑 Contribution Guidelines
• 📜 License & Credits

🌌 The Vision

NovOS is a cinematic, browser-based operating environment that redefines the relationship between the web and desktop computing. It is a Web-Based OS Interface / Desktop UI Simulation.

Our mission is to provide a distraction-free, high-fidelity workspace where developers and creators can manage their digital lives without ever leaving the browser tab.

"The future of computing is not on your disk, but in your mind. We are just building the interface."

🖥️ User Interface & Experience

The Aether Design Language

Aether is the soul of NovOS — a design system optimized for modern high-resolution displays.

Spotlight Search

Activated with Ctrl + Space — the fastest navigation tool in NovOS.

• Fuzzy Search — Find apps, files, and settings with minimal keystrokes.
• AI Integration — Ask Nova questions directly from the search bar.
• Quick Actions — Type theme dark / theme light to switch instantly.

Mission Control & Workspaces

Ctrl + Tab activates a bird's-eye view of all open windows using a specialized non-overlapping layout algorithm. NovOS supports up to 10 virtual workspaces — move windows between them via the overlay or with keyboard shortcuts.

Cinematic Window Management

• Snap Engine — Windows snap to screen edges and quadrants with magnetic precision.
• Physics Drag — Spring-based window dragging that feels weighted and real.
• PiP Support — Pin any app to float above all other windows.
• Global Close — Esc dismisses overlays and returns focus to the desktop.

📦 Application Ecosystem

NovOS ships with a curated set of high-fidelity applications and a Nexus App Store with 400+ available packages.

📸 Preview Images

🖥️ Live Desktop View

📋 Full Application Registry (v1.3.0)

🏛️ System & Core

🛠️ Development Tools

📈 Productivity & Office

🎨 Creative & Media

🌐 Internet & Communication

🧠 AI & Neural Interface

🎮 Gaming & Entertainment

App Registry Statistics

Total Registered  ░░░░░░░░░░░░░░░░░░░░  428
Core System Apps  ░░░░░░░░░░░░░░░░░░░░   42
Productivity      ░░░░░░░░░░░░░░░░░░░░  115
Development       ░░░░░░░░░░░░░░░░░░░░   88
Media & Creative  ░░░░░░░░░░░░░░░░░░░░   94
AI & Neural       ░░░░░░░░░░░░░░░░░░░░   32
Miscellaneous     ░░░░░░░░░░░░░░░░░░░░   57

⌨️ Global Hotkeys & Shell Reference

Global System Shortcuts

The novash Command Suite

File Management

System Control

Nova AI Interface

Advanced Command Flags

ls — -a (hidden files) · -l (long format) · -h (human-readable sizes) · -R (recursive) · -S (sort by size) · -t (sort by time)

rm — -f (force, no confirmation) · -r (recursive) · -v (verbose output)

cp — -r (recursive) · -v (verbose) · -p (preserve permissions & timestamps)

grep — -i (ignore case) · -v (invert match) · -n (show line numbers)

🔐 Security, Identity & Authentication

NovOS implements a multi-layer security model inspired by real UNIX systems.

Multi-User Environment

• Root vs User — Only users in the root group can modify system files in /etc/ or bundles in /usr/apps/.
• Identity Persistence — Each user's desktop and filesystem are fully isolated.
• POSIX Permissions — Every VFS node carries a drwxr-xr-x-style permission string with owner/group assignment.

Default Credentials

Note: The following credentials are purely mock values for demo UI testing:

Authentication Flow

[ Login Screen ] → [ Credential Hash Check ] → [ Session Hydration ]
       ↑                      |                         |
       |              [ Auth Failure ]           [ Desktop Init ]
       └──────────────────────┘

🛠️ Core Developer Documentation

Project Structure

/
├── index.html              # Boot entry point
├── favicon.svg
├── icons.svg
└── assets/                 # Frontend UI build assets (JS/CSS)

API Reference (window.kernel)

Filesystem Subsystem

const fs = window.kernel.fs;

// Write a file
await fs.writeFile('/home/operator/hello.txt', 'Hello NovOS');

// Read a file
const content = await fs.readFile('/home/operator/hello.txt');

// Check if a node exists
const exists = await fs.exists('/home/operator/hello.txt');

// List a directory
const entries = await fs.readDir('/home/operator/Documents');

// Remove a node
await fs.remove('/home/operator/hello.txt');

Process Subsystem

const pm = window.kernel.process;

// Launch an application
const pid = pm.launch('terminal', { cwd: '/etc' });

// List all running processes
const procs = pm.list();

// Terminate a process
pm.terminate(pid);

Event Bus

const bus = window.kernel.events;

// Subscribe to a kernel event
bus.on('fs:ready', () => console.log('VFS is online'));

// Emit a custom event
bus.emit('app:custom-event', { data: 'payload' });

Adding a New App

1. Create your component in assets/components/apps/MyApp.js.
2. Register the app in appRegistry.js:

myApp: {
  title: 'My App',
  icon: 'rocket',
  category: 'Utilities',
  w: 600,
  h: 400,
  permissions: []
}

3. Add a launcher to the dock or desktop in osStore.js.
4. Ensure the component responds to Esc for window close.
5. Use --glass-material and --accent-cyan tokens for styling.

🎨 Aether Token System

All custom apps must use these CSS variables, defined globally on :root.

Surface Tokens

:root {
  --bg-primary:       #050509;      /* Main window background          */
  --glass-material:   rgba(255,255,255,0.05); /* Translucent surfaces  */
  --glass-stroke:     rgba(255,255,255,0.08); /* Window border         */
  --glass-shadow:     0 8px 32px rgba(0,0,0,0.6); /* Window depth      */
  --blur-radius:      24px;         /* Standard glassmorphic blur       */
}

Typography Tokens

:root {
  --font-main:    'Inter Variable', sans-serif;
  --font-mono:    'JetBrains Mono', monospace;
  --text-heading: rgba(255,255,255,0.95);
  --text-body:    rgba(255,255,255,0.65);
  --text-muted:   rgba(255,255,255,0.35);
}

Color & Interaction Tokens

:root {
  --accent-cyan:    #00d4ff;   /* Primary accent  */
  --accent-purple:  #bd00ff;   /* Secondary accent */
  --hover-glow:     radial-gradient(circle, rgba(0,212,255,0.15), transparent 70%);
  --active-scale:   0.98;      /* Tap feedback     */
}

/etc/theme.css (Runtime Override)

:root {
  --accent-color: #00d4ff;
  --blur-radius:  24px;
  --glass-opacity: 0.1;
  --font-family:  'JetBrains Mono', monospace;
}

🚀 Roadmap & Future Vistas

✅ v1.3.0-PRO (Current)

• POSIX VFS backed by IndexedDB with full persistence
• 40+ pre-installed apps, 400+ in the Nexus Store
• Multi-workspace support (up to 10 virtual desktops)
• Nova AI with file context and shell command generation
• Cinematic Aether glassmorphic design system
• Multi-user identity with POSIX-style permissions
• Lock screen, session lifecycle, and recovery mode

🔜 v2.0 (Planned)

• Native File System Access — Sync local machine folders with NovOS
• Extension API — Load third-party .nova bundles dynamically
• Multiplayer Mode — Collaborate on the same VFS via WebRTC
• Mobile Deck — Specialized tablet/mobile UI layout

🔭 v3.0 (Vision)

• NovaVM — Lightweight in-browser virtual machine
• NovaDocker — Full app containerization manager
• Neural Link — Direct brain-inspired visual interface simulation
• CI/CD Pipeline — Full build automation and testing suite

🕰️ Changelog

v1.3.0-PRO (April 2026)

• New: Advanced session lifecycle (Lock Screen, Session Rehydration)
• New: Mission Control window overview with non-overlapping layout
• New: Nova AI v2.4.1 with VFS-aware path resolution
• Security: Cryptographic bundle verification for all system apps
• Performance: VFS transaction batching optimized by 40%
• UI: Aether Design System v2 — improved motion physics

v1.2.0

• Implemented cryptographic bundle verification
• Added "Mission Control" window overview mode
• Nova now supports multi-file context analysis

v1.1.0

• Introduced Virtual File System (VFS) with IndexedDB persistence
• Dynamic glassmorphism and theme engine
• Released Code Editor with Monaco + syntax highlighting

v1.0.0

• Initial Release: Core kernel and basic window manager

❓ Troubleshooting & FAQ

Q: How do I perform a full factory reset?
Open the Terminal and run rm -rf /, then refresh the page. This wipes the virtual disk and triggers the default VFS re-population script.

Q: Why do my apps close on page refresh?
By design — NovOS only persists your filesystem and identity across refreshes. Active processes are volatile and cleared to ensure a clean kernel environment.

Q: Is my data safe if I clear my browser cache?
No. NovOS stores everything in IndexedDB. A "Clear Site Data" action will wipe your virtual disk. Use File Manager → Export to back up important files to your local machine.

Q: An app window is running but invisible (off-screen)?
Open Mission Control (Ctrl + Tab), locate the window preview, and click it to re-center.

Q: Terminal says "command not found" for basic commands?
Your PATH variable is unset. Run /bin/ls using the absolute path to verify the binary exists, then repair your .bashrc.

Q: Login screen reappears after the correct password?
Clear browser cookies and ensure "Third-party storage" is allowed in your browser's site settings.

Q: My VFS is slow or behaving strangely?
Open DevTools → Application → IndexedDB → novos-vfs-db → Delete Database. Then refresh.

📚 System Glossary

📑 Contribution Guidelines

We welcome all visionary developers to help build the future of the browser-based OS.

1. Fork the repo and create a feature branch.
2. Glass-First Design — Every UI element must respect Aether transparency and blur tokens.
3. Persistence Integrity — Never perform a VFS action without proper IndexedDB error handling.
4. Event-Driven Logic — Prefer the Kernel Event Bus over direct component communication.
5. Cinematic Motion — All transitions must use spring-based physics (no linear easing).
6. No Placeholders — Never use Lorem Ipsum or placeholder images in PRs.
7. Testing — Ensure your app works across all workspaces and responds to Esc for close.
8. Documentation — Every PR must include an update to var/log/development.log.
9. Security — Never expose raw password hashes in logs or terminal output.
10. Respect — Honor the vision of a unified, cinematic browser-based experience.

📋 Bugs → Report on GitHub Issues
💡 Features → Propose in the Discord community
🎨 Art → Submit wallpapers for the default gallery
📦 Extensions → Develop .nova bundles and share them

📜 License & Credits

NovOS is open-source software released under the MIT License.

"The screen is not a wall — it is a window into a deeper reality."
NovOS v1.3.0-PRO "Aether" · Released April 2026 · Built with 🌌 by Tcode-Motion

👤 Author & License

• Author: Tcode-Motion
• License: Distributed under the MIT License. See LICENSE for details.