---
╔════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 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." ║
║ ║
╚════════════════════════════════════════════════════════════════════════════╝
- 🌌 The Vision
- 🏗️ System Architecture
- 🖥️ User Interface & Experience
- 📦 Application Ecosystem
- 📋 Full Application Registry (v1.3.0)
- ⌨️ Global Hotkeys & Shell Reference
- 🔐 Security, Identity & Authentication
- 🛠️ Core Developer Documentation
- 🛰️ Kernel Event Protocol
- 🎨 Aether Token System
- 🚀 Roadmap & Future Vistas
- 🕰️ Changelog
- 📋 Default VFS Manifest
- ⚙️ Kernel Configuration Examples
- 🔍 System Log Examples
- ❓ Troubleshooting & FAQ
- 📚 System Glossary
- 📑 Contribution Guidelines
- 📜 License & Credits
NovOS is a cinematic, browser-based operating environment that redefines the relationship between the web and desktop computing. It is not merely a "skin" for a website — it is a fully integrated micro-kernel OS, complete with a POSIX-compliant virtual file system, security model, process lifecycle management, and a sophisticated event bus.
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."
NovOS is built on the principle of Isolation & Orchestration — every subsystem operates independently and communicates through a central event bus.
The kernel operates as the central arbiter of the system, written in highly optimized vanilla JavaScript to ensure zero overhead.
| Subsystem | Role |
|---|---|
| Neural Event Bus | Orchestrates 100+ system events, from file writes to battery state changes |
| VFS Manager | Manages the link between in-memory file trees and IndexedDB persistence |
| Window Scheduler | Controls focus, z-index, and rendering cycle of all active windows |
| HAL | Interfaces with browser-level APIs (WebAudio, Battery API, WebGL) for a consistent app interface |
[ USER INTERFACE LAYER (Aether) ]
|
+-- Desktop Shell (Phase: Desktop)
+-- Authentication Shell (Phase: Login)
+-- Overlay Stack (Spotlight, Mission Control)
|
[ STATE ORCHESTRATION LAYER ]
|
+-- User Store (Identity, Files, Credentials)
+-- OS Store (Windows, Processes, Hardware State)
|
[ KERNEL LAYER (window.kernel) ]
|
+-- FS: Virtual File System Controller
+-- PROC: Process & App Lifecycle Manager
+-- EVT: Neural Event Bus System
+-- HAL: Browser API Bridge
|
[ PERSISTENCE LAYER ]
|
+-- POSIX Abstraction Interface
+-- IndexedDB Storage (novos-vfs-db)
The VFS is a full POSIX-compliant implementation backed by IndexedDB.
- True Persistence — Unlike
localStorage, IndexedDB survives browser refreshes and supports large structured data. - Path Resolution — Supports absolute paths (
/etc/config), relative paths (../docs), and home shortcuts (~/Desktop). - Permissions — Every node carries a 10-character permission string (e.g.,
drwxr-xr-x) with owner/group assignment. - Integrity — On every boot, the kernel runs a checksum pass across all mounted partitions.
Applications are treated as signed system packages, not raw components.
- Registry — All apps must be defined in
APP_REGISTRYwith dimensions, category, and permission scope. - Verification — During boot, cryptographic bundles in
/usr/apps/are validated. Invalid signatures block the launch. - Sandboxing — Installed apps run in strict isolation and must explicitly request hardware access (Camera, Mic, Network).
Aether is the soul of NovOS — a design system optimized for modern high-resolution displays.
| Principle | Implementation |
|---|---|
| Layered Glassmorphism | backdrop-filter: blur(24px) + rgba(255,255,255,0.05) for cinematic depth |
| Subtle Gradients | Wide-gamut HSL colors to prevent banding in dark environments |
| Motion Orchestration | Framer Motion spring physics — natural, weighted animations |
| Typography | JetBrains Mono (terminal) + Inter Variable (UI) |
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 lightto switch instantly.
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.
- 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 —
Escdismisses overlays and returns focus to the desktop.
NovOS ships with a curated set of high-fidelity applications and a Nexus App Store with 400+ available packages.
Note
Status Codes:
- 🟢 Installed — Shipped with the current build.
- 🔵 Available — Can be installed via Nexus Store.
- 🟡 Coming Soon — Planned for a future kernel update.
---
| App ID | Name | Status | Description |
|---|---|---|---|
files |
Files Pro | 🟢 | Advanced VFS File Explorer |
terminal |
Terminal Pro | 🟢 | POSIX-compliant terminal emulator |
settings |
Settings | 🟢 | System-wide configuration engine |
appStore |
Nexus Store | 🟢 | Application management hub |
taskManager |
Task Manager | 🟢 | Process and resource monitor |
powerShell |
Power Hub | 🟢 | Advanced power state manager |
notifHub |
Notif Center | 🟢 | Centralized system alert hub |
sysInfo |
About NovOS | 🟢 | Detailed build specifications |
sysMonitor |
System Monitor | 🔵 | Real-time hardware telemetry |
userManager |
User Manager | 🔵 | Multi-user identity controller |
secCenter |
Security Hub | 🔵 | Firewall and encryption manager |
updateMgr |
Update Manager | 🔵 | Kernel update orchestration |
diskUtil |
Disk Utility | 🔵 | VFS partitioning and optimization |
backupMgr |
Backup & Sync | 🔵 | VFS-to-cloud backup bridge |
netDiagnose |
Network Diag | 🔵 | Latency and throughput analyzer |
btMgr |
Bluetooth Mgr | 🔵 | Virtual device pairing interface |
eventLog |
Event Viewer | 🔵 | Real-time kernel event stream |
fontMgr |
Font Manager | 🔵 | System typography customizer |
keyMap |
Keyboard Mapper | 🔵 | Custom hotkey and macro editor |
displaySet |
Display Pro | 🔵 | Advanced resolution & HDR config |
audioEngine |
Audio Console | 🔵 | Multi-channel audio mixer |
shellTheme |
Shell Styler | 🔵 | Terminal theme personalization |
lockSet |
Lock Screen Pro | 🔵 | Dynamic lock screen customization |
searchIndex |
Search Indexer | 🔵 | Background file indexing daemon |
vfsMount |
VFS Mounter | 🔵 | Mount remote cloud drives |
systemCheck |
Integrity Check | 🔵 | Kernel health verification |
recoveryEnv |
Recovery Mode | 🔵 | System repair and reset tools |
devTools |
Sys Dev Tools | 🔵 | Low-level kernel debugging |
taskSched |
Task Scheduler | 🔵 | Automate system commands |
tempClear |
Temp Cleaner | 🔵 | One-click /tmp/ and cache wipe |
privacySet |
Privacy Guard | 🔵 | Granular permission control |
accessibility |
Accessibility | 🔵 | Screen reader and zoom tools |
vfsSnapshot |
VFS Snap | 🔵 | File system snapshot manager |
perfTuner |
Perf Optimizer | 🔵 | One-click speed boost |
crashReport |
Crash Handler | 🔵 | Error collection and reporting |
regEdit |
Registry Editor | 🟡 | Low-level system config editor |
langPack |
Lang Pack Mgr | 🟡 | Multi-language support engine |
driverMgr |
Driver Hub | 🟡 | Virtual hardware driver manager |
bootConfig |
Boot Loader | 🟡 | UEFI-style boot configuration |
processGuard |
Process Guard | 🟡 | Anti-malware process isolation |
remoteDesktop |
Remote View | 🟡 | Remote access server |
virtMachine |
NovaVM | 🟡 | Lightweight VM simulation |
containerMgr |
NovaDocker | 🟡 | App containerization manager |
biometrics |
Bio-Identity | 🟡 | Fingerprint and face ID sim |
| App ID | Name | Status | Description |
|---|---|---|---|
codeEditor |
VS Code (Nova) | 🟢 | Full Monaco-based IDE |
mdEditor |
Markdown Pro | 🟢 | Dual-pane MD editor |
pyStudio |
Python IDE | 🔵 | Integrated Python environment |
jsConsole |
JS Runtime | 🔵 | Interactive Node-like REPL |
dbExplorer |
DB Browser | 🔵 | SQL and NoSQL database viewer |
apiTester |
Nexus API | 🔵 | REST and GraphQL test suite |
gitClient |
Git Pro | 🔵 | Graphical Git interface |
hexEditor |
Hex Master | 🔵 | Binary file editor |
regexTester |
Regex Hub | 🔵 | Pattern matching test tool |
sshClient |
NovaSSH | 🔵 | Remote server terminal |
ftpClient |
NovaFTP | 🔵 | VFS-to-SFTP bridge |
packageMgr |
nvm (Nova) | 🔵 | Node version and package manager |
debugger |
Kernel Debug | 🔵 | Real-time process debugger |
profiler |
Performance Lab | 🔵 | Code profiling and flamegraphs |
schemaGen |
Schema Architect | 🔵 | Database schema visualizer |
wasmRunner |
WASM Host | 🔵 | Run WebAssembly modules |
compilers |
NovaBuild | 🔵 | C++/Rust/Go cross-compilers |
linterHub |
Lint Master | 🔵 | Global linter configuration |
snippetMgr |
Snippet Lab | 🔵 | Reusable code block manager |
umlDesigner |
UML Pro | 🔵 | Diagram and flowchart tool |
portScanner |
Net Scanner | 🔵 | Security port mapping tool |
cryptoTool |
Cipher Studio | 🔵 | AES/RSA encryption utility |
webServer |
NovaServer | 🔵 | Local HTTP server for VFS |
unitTester |
Test Suite | 🔵 | TDD framework runner |
logAnalyzer |
Log Master | 🔵 | Semantic log parsing engine |
envEditor |
Env Manager | 🔵 | System variable editor |
dependency |
Dep Graph | 🔵 | Project dependency visualizer |
refactor |
Refactor AI | 🔵 | AI-driven code refactoring |
dockerSim |
Docker View | 🟡 | Container visualization |
uiBuilder |
Visual Studio | 🟡 | Drag-and-drop UI designer |
buildAuto |
Pipeline | 🟡 | CI/CD pipeline simulator |
codeReview |
Reviewer | 🟡 | Automated code audit tool |
androidStudio |
Mobile Lab | 🟡 | Android emulation bridge |
| App ID | Name | Status | Description |
|---|---|---|---|
editor |
Text Editor | 🟢 | Lightweight notepad |
calendar |
Calendar Pro | 🟢 | Event and schedule planner |
calculator |
Calculator | 🟢 | Scientific math processor |
zipArch |
Archive Pro | 🟢 | ZIP/7Z/TAR compression tool |
clipboard |
Clip Master | 🟢 | Clipboard history manager |
reminders |
Task List | 🔵 | Hierarchical Todo manager |
notes |
Sticky Notes | 🔵 | Quick desktop post-its |
contacts |
Contacts | 🔵 | Unified address book |
email |
Email Client | 🔵 | Multi-protocol IMAP/SMTP |
sheet |
Nova Sheets | 🔵 | High-perf spreadsheet engine |
slides |
Nova Slides | 🔵 | Cinematic presentation tool |
words |
Nova Docs | 🔵 | Rich-text document processor |
kanban |
Nova Flow | 🔵 | Project management board |
timer |
Pomodoro | 🔵 | Productivity focus timer |
expense |
Wallet | 🔵 | Personal finance tracker |
clock |
World Clock | 🔵 | Global time and alarm hub |
weather |
Nova Forecast | 🔵 | Dynamic weather visualization |
translate |
Translator | 🔵 | 100+ language neural translation |
mindmap |
Mind Studio | 🔵 | Brainstorming node map |
journal |
Diary | 🔵 | Private encrypted journal |
pdfViewer |
PDF Studio | 🔵 | PDF reader and annotator |
syncDrive |
Cloud Drive | 🔵 | Google/Dropbox VFS sync |
password |
Vault | 🔵 | Encrypted password manager |
timeTrack |
Punch Clock | 🔵 | Freelance time tracking |
whiteboard |
Sketch Pad | 🔵 | Virtual brainstorming board |
mapView |
Global Maps | 🔵 | Interactive 3D globe |
fitness |
Workout Pro | 🔵 | Health and exercise logger |
meditate |
Zen Mode | 🔵 | Guided focus and meditation |
crm |
Nova CRM | 🟡 | Customer relationship manager |
erp |
Nova ERP | 🟡 | Resource planning suite |
collab |
Team View | 🟡 | Real-time doc collaboration |
| App ID | Name | Status | Description |
|---|---|---|---|
gallery |
Image Studio | 🟢 | High-res image gallery |
imageViewer |
Photo Viewer | 🟢 | Minimalist image reader |
musicPlayer |
Music Studio | 🟢 | Audio player & visualizer |
videoPlayer |
Movie Theater | 🟢 | 4K video playback engine |
audioRecorder |
Voice Studio | 🟢 | Waveform audio recorder |
camera |
Camera Pro | 🟢 | Snapshots & video capture |
snapshot |
Quick Cap | 🟢 | Instant desktop screenshot |
screenRec |
Screen Rec | 🟢 | HD screen recording utility |
photoEditor |
Pixel Studio | 🔵 | Layer-based image editor |
draw |
Vector Pro | 🔵 | SVG and vector designer |
audioEdit |
Nova Wave | 🔵 | DAW and sound designer |
iconMaker |
Icon Gen | 🔵 | Favicon and app icon tool |
colorPicker |
Color Lab | 🔵 | Advanced palette generator |
spectrum |
Audio Viz | 🔵 | Full-screen music visualizer |
drumPad |
Beat Maker | 🔵 | Step sequencer and sampler |
synth |
Nova Synth | 🔵 | Polyphonic virtual synth |
spriteEdit |
Sprite Lab | 🔵 | Pixel art and sprite tool |
mapEditor |
World Build | 🔵 | Tiled map and level editor |
videoEdit |
Nova Cut | 🟡 | Multi-track video editor |
animation |
Motion Pro | 🟡 | 2D animation and rigging |
3dModeler |
Nova 3D | 🟡 | Low-poly modeling suite |
fontStudio |
Font Creator | 🟡 | Custom font design engine |
djStudio |
Nova Mix | 🟡 | Virtual DJ deck and mixer |
gameDev |
Game Maker | 🟡 | No-code game logic builder |
| App ID | Name | Status | Description |
|---|---|---|---|
browser |
Nova Browser | 🟢 | Security-first web browser |
cloud |
Cloud Drive | 🟢 | Unified storage manager |
downloader |
Fetch Pro | 🟢 | Multi-threaded downloader |
messaging |
Nova Chat | 🔵 | Unified IM (Discord/Slack) |
videoChat |
Nova Meet | 🔵 | WebRTC video conferencing |
social |
Social Hub | 🔵 | Social media aggregator |
news |
News Wire | 🔵 | Global breaking news feed |
torrent |
Nova Seed | 🔵 | VFS-based torrent client |
wallet |
Crypto Hub | 🔵 | Multi-chain crypto wallet |
adBlock |
Guard Pro | 🔵 | System-wide ad & tracker blocker |
bookmarks |
Links Hub | 🔵 | Cross-app bookmark manager |
vpn |
Nova Tunnel | 🟡 | Built-in VPN interface |
| App ID | Name | Status | Description |
|---|---|---|---|
nova |
Nova AI | 🟢 | Central system assistant |
novaChat |
AI Chat | 🟢 | Interactive LLM interface |
novaSuggest |
Smart Suggest | 🟢 | OS-wide predictive typing |
novaDoc |
AI Document | 🔵 | AI-driven document analysis |
novaCode |
Copilot | 🔵 | AI code completion engine |
novaGen |
Image Gen | 🔵 | Stable Diffusion integration |
novaVision |
OCR Pro | 🔵 | AI image text extraction |
novaTrans |
AI Translate | 🔵 | Real-time speech translation |
novaSummar |
Summarizer | 🔵 | Instant webpage/file summary |
novaVoice |
Voice AI | 🟡 | Neural TTS and STT engine |
novaData |
Data Analyst | 🟡 | Automated data processing |
| App ID | Name | Status | Description |
|---|---|---|---|
emulator |
Retro Hub | 🔵 | NES/SNES/GBA emulator |
chess |
Grandmaster | 🔵 | AI-powered chess engine |
minesweeper |
Mines | 🔵 | Classic logic puzzle |
solitaire |
Solitaire | 🔵 | Classic card game |
arcade |
Nexus Arcade | 🔵 | Browser-based indie games |
sudoku |
Sudoku Pro | 🔵 | Logic-based number puzzle |
crossword |
Puzzles | 🔵 | Daily crossword challenges |
novaQuest |
Nova RPG | 🟡 | Original terminal-based RPG |
streamer |
Nova Play | 🟡 | Cloud gaming interface |
Total Registered ░░░░░░░░░░░░░░░░░░░░ 428
Core System Apps ░░░░░░░░░░░░░░░░░░░░ 42
Productivity ░░░░░░░░░░░░░░░░░░░░ 115
Development ░░░░░░░░░░░░░░░░░░░░ 88
Media & Creative ░░░░░░░░░░░░░░░░░░░░ 94
AI & Neural ░░░░░░░░░░░░░░░░░░░░ 32
Miscellaneous ░░░░░░░░░░░░░░░░░░░░ 57
| Shortcut | Action | Description |
|---|---|---|
Ctrl + Space |
Spotlight | Universal search for apps, files, and AI |
Ctrl + Tab |
Mission Control | Bird's-eye view of all active windows |
Ctrl + L |
Lock Screen | Instant session suspension; apps keep running |
Ctrl + Q |
Logout | Terminates all processes and clears session |
Ctrl + T |
Terminal | Spawns a new Terminal instance |
Ctrl + N |
Notifications | Toggles the global notification sidebar |
Ctrl + Shift + P |
Power Hub | Access Lock / Logout / Reboot from anywhere |
Ctrl + Shift + N |
New Folder | Creates a folder in the active desktop context |
Alt + Tab |
Cycle Focus | Jump between the last two active windows |
F5 |
Safe Refresh | Soft-reboots the OS, preserves authentication |
Esc |
Global Close | Dismisses active overlays or focuses Desktop |
| Command | Description |
|---|---|
ls [path] |
List directory contents |
cd [path] |
Change working directory |
cat [file] |
Output file contents to terminal |
mkdir [-p] [name] |
Create directory (with parents) |
touch [name] |
Create an empty file |
rm [-rf] [path] |
Remove file or directory |
cp [-rv] [src] [dest] |
Copy files or directories |
mv [src] [dest] |
Move or rename a node |
grep [-inv] [pattern] [file] |
Search for a pattern in a file |
chmod [mode] [file] |
Change file permission bits |
chown [owner] [file] |
Change file ownership |
| Command | Description |
|---|---|
ps |
List all active processes |
kill [pid] |
Terminate a process by PID |
top |
Real-time kernel task dashboard |
uptime |
Show time since last boot |
whoami |
Print current user identity |
df |
Show VFS disk space usage |
clear |
Clear terminal output buffer |
help |
List all available commands |
| Command | Description |
|---|---|
nova ask "[query]" |
Get a quick AI answer |
nova chat |
Start an interactive AI session |
nova analyze [file] |
Deep AI analysis of a specific file |
nova status |
Check neural engine connectivity |
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)
NovOS implements a multi-layer security model inspired by real UNIX systems.
- Root vs User — Only users in the
rootgroup 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.
| User | Password | Role |
|---|---|---|
operator |
admin |
Root / System Administrator |
guest |
(none) | Standard User |
[ Login Screen ] → [ Credential Hash Check ] → [ Session Hydration ]
↑ | |
| [ Auth Failure ] [ Desktop Init ]
└──────────────────────┘
/
├── index.html # Boot entry point
├── favicon.svg
├── icons.svg
└── assets/
├── /components
│ ├── /apps # Individual application components
│ ├── /os # Core UI (Desktop, Dock, Taskbar)
│ └── /overlays # Global UI (Spotlight, Mission Control)
├── /kernel # FS, AppLoader, Kernel.js
├── /store # Global state (Zustand)
└── /styles # CSS and Aether design tokens
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');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);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' });- Create your component in
assets/components/apps/MyApp.js. - Register the app in
appRegistry.js:
myApp: {
title: 'My App',
icon: 'rocket',
category: 'Utilities',
w: 600,
h: 400,
permissions: []
}- Add a launcher to the dock or desktop in
osStore.js. - Ensure the component responds to
Escfor window close. - Use
--glass-materialand--accent-cyantokens for styling.
| Event Name | Trigger | Payload |
|---|---|---|
kernel:booting |
Boot sequence starts | null |
kernel:ready |
All subsystems online | { bootTime: number } |
fs:ready |
IndexedDB connection established | null |
fs:write |
File written to VFS | { path: string, size: number } |
os:error |
Critical system error | { title: string, message: string } |
window:focus |
User focuses a window | { id: string, app: string } |
window:close |
Window is terminated | { id: string, pid: number } |
battery:change |
Device battery updates | { level: number, charging: boolean } |
network:change |
System goes online/offline | { online: boolean } |
auth:login |
User authenticates | { user: string, uid: number } |
auth:logout |
Session terminated | { user: string } |
auth:lock |
Screen locked | null |
All custom apps must use these CSS variables, defined globally on :root.
: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 */
}: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);
}: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 */
}:root {
--accent-color: #00d4ff;
--blur-radius: 24px;
--glass-opacity: 0.1;
--font-family: 'JetBrains Mono', monospace;
}- 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
- Native File System Access — Sync local machine folders with NovOS
- Extension API — Load third-party
.novabundles dynamically - Multiplayer Mode — Collaborate on the same VFS via WebRTC
- Mobile Deck — Specialized tablet/mobile UI layout
- 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
- 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
- Implemented cryptographic bundle verification
- Added "Mission Control" window overview mode
- Nova now supports multi-file context analysis
- Introduced Virtual File System (VFS) with IndexedDB persistence
- Dynamic glassmorphism and theme engine
- Released Code Editor with Monaco + syntax highlighting
- Initial Release: Core kernel and basic window manager
The base NovOS image ships with the following file nodes pre-populated:
/bin/sh /bin/ls /bin/cat
/bin/mkdir /bin/rm /bin/cp
/bin/mv /bin/grep /bin/ps
/bin/kill /bin/chmod
/etc/passwd /etc/group /etc/hosts
/etc/motd /etc/fstab /etc/profile
/etc/bashrc /etc/theme.css /etc/kernel.conf
/usr/lib/libvfs.js /usr/lib/libkernel.js
/usr/apps/terminal.bundle /usr/apps/editor.bundle
/usr/apps/code.bundle /usr/apps/files.bundle
/usr/apps/settings.bundle /usr/apps/taskmgr.bundle
/usr/apps/music.bundle /usr/apps/video.bundle
/usr/apps/gallery.bundle /usr/apps/appstore.bundle
/home/operator/Desktop/Welcome.md
/home/operator/Desktop/Manifesto.txt
/home/operator/Documents/Project.js
/home/operator/Pictures/Wallpaper.png
/home/operator/Music/Sample.mp3
/home/operator/.bashrc /home/operator/.profile
/var/log/sys.log /var/log/auth.log /var/log/vfs.log
/var/run/kernel.pid
/dev/null /dev/zero /dev/random
/dev/tty
Total base nodes: 47
# NovOS User Database
# format: user:pass_hash:uid:gid:gecos:home:shell
operator:$2a$12$K.lP...:0:0:System Operator:/home/operator:/bin/novash
guest:*:100:100:Guest User:/home/guest:/bin/novash
Welcome to NovOS Professional Edition v1.3.0-PRO
============================================
* Kernel: Stable 5.4.1-NOV
* Nova Engine: Active (v2.4.1)
* Disk Status: 42% Available
* Session ID: NOV-9928-XA
Type 'help' for a list of available commands.
# User Aliases
alias ll='ls -al'
alias la='ls -A'
alias l='ls -CF'
alias cls='clear'
# Environment Variables
export PATH=$PATH:/usr/local/bin
export EDITOR=nova-editor[00:00:01] KERNEL: Initializing neural event bus...
[00:00:01] KERNEL: Loading Aether Design Tokens into DOM...
[00:00:02] VFS: Probing IndexedDB backend (novos-vfs-db)...
[00:00:02] VFS: Mounting root partition (/).
[00:00:03] VFS: Found 428 file nodes. Integrity check: OK.
[00:00:03] VFS: Syncing /etc/passwd with userStore...
[00:00:04] HAL: Probing hardware capabilities...
[00:00:04] HAL: WebAudio: Enabled. WebGL: Enabled. BatteryAPI: Ready.
[00:00:05] AUTH: Identity Manager ready. MIRROR_MODE enabled.
[00:00:06] SHELL: Loading .bashrc into novash instance...
[00:00:07] APP: Verified system bundle: terminal.bundle
[00:00:07] APP: Verified system bundle: code.bundle
[00:00:08] UI: Aether Design Engine warmed up (32ms).
[00:00:09] NET: Establishing heartbeat with Nova neural engine...
[00:00:10] SYSTEM: Phase transition [BOOT -> LOGIN].
[00:00:10] KERNEL: Boot sequence complete. Uptime: 10.4s.
[00:00:01.270] [AUTH] Starting Identity Daemon (identityd)...
[00:00:01.285] [AUTH] Loading secure credentials store...
[00:00:01.285] [AUTH] Authenticating session rehydration request...
[00:00:01.285] [AUTH] Rehydration Success: User 'Operator' (UID: 0).
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.
| Term | Definition |
|---|---|
| Aether | The proprietary glassmorphic design system used across all NovOS interfaces |
| Bundle | A cryptographically signed package containing app logic, metadata, and security tokens |
| Daemon | A background process (e.g., novad) that handles system-level tasks |
| Fuzzy Search | Approximate string-matching algorithm powering the Spotlight overlay |
| Glassmorphism | Visual style using semi-transparent surfaces with high-blur backdrops |
| HAL | Hardware Abstraction Layer — bridges kernel requests to browser APIs |
| Kernel | The master logic controller of NovOS, running as a JS singleton |
| Mission Control | Overlay mode providing a bird's-eye view of all open windows |
| PID | Process Identifier — unique integer assigned to every active window or service |
| POSIX | Portable Operating System Interface — the standard NovOS follows for its VFS |
| Rehydration | Loading saved state from IndexedDB into memory at boot time |
| VFS | Virtual File System — an IndexedDB-backed abstraction layer simulating a real disk |
| Workspace | A virtual desktop container that holds a specific set of windows |
We welcome all visionary developers to help build the future of the browser-based OS.
- Fork the repo and create a feature branch.
- Glass-First Design — Every UI element must respect Aether transparency and blur tokens.
- Persistence Integrity — Never perform a VFS action without proper IndexedDB error handling.
- Event-Driven Logic — Prefer the Kernel Event Bus over direct component communication.
- Cinematic Motion — All transitions must use spring-based physics (no linear easing).
- No Placeholders — Never use Lorem Ipsum or placeholder images in PRs.
- Testing — Ensure your app works across all workspaces and responds to
Escfor close. - Documentation — Every PR must include an update to
var/log/development.log. - Security — Never expose raw password hashes in logs or terminal output.
- 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.novabundles and share them
NovOS is open-source software released under the MIT License.
| Contribution | Source |
|---|---|
| Lead Developer | Tcode-Motion |
| Icons | Fluent Emoji by Microsoft & Lucide React |
| Typography | Inter Variable by RSMS |
| UI Engine | React + Vite |
| Animations | Framer Motion |
| 🔥 Project | 📖 Description |
|---|---|
| 🌌 NovOS | A cinematic web OS — POSIX VFS, Nova AI, Aether Design |
| 🐉 TechScript | A programming language — Native Rust VM + web builder |
| 🧠 Project JARVIS | Personal AI assistant built in Python |
| 🎨 3D Visuals | WebGL particle systems + Three.js experiences |
| 🤖 AR Keyboard | Hand-gesture virtual keyboard with OpenCV + MediaPipe |


