Skip to content

Tcode-Motion/NovOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Typing SVG

Live Experience Version Kernel Status Architecture Security License


📸 Preview Images

🎨 Main Interface

NovOS 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

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."


🏗️ System Architecture

NovOS is built on the principle of Isolation & Orchestration — every subsystem operates independently and communicates through a central event bus.

The Micro-Kernel Core

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

Architecture Topology

[ 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 Virtual File System (VFS)

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.

Security & AppLoader Sandbox

Applications are treated as signed system packages, not raw components.

  1. Registry — All apps must be defined in APP_REGISTRY with dimensions, category, and permission scope.
  2. Verification — During boot, cryptographic bundles in /usr/apps/ are validated. Invalid signatures block the launch.
  3. Sandboxing — Installed apps run in strict isolation and must explicitly request hardware access (Camera, Mic, Network).

🖥️ User Interface & Experience

The Aether Design Language

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)

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 CloseEsc 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.

Note

Status Codes:

  • 🟢 Installed — Shipped with the current build.
  • 🔵 Available — Can be installed via Nexus Store.
  • 🟡 Coming Soon — Planned for a future kernel update.

📸 Preview Images

🖥️ Live Desktop View

NovOS Desktop View
---

📋 Full Application Registry (v1.3.0)

🏛️ System & Core

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

🛠️ Development Tools

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

📈 Productivity & Office

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

🎨 Creative & Media

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

🌐 Internet & Communication

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

🧠 AI & Neural 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

🎮 Gaming & Entertainment

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

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

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

The novash Command Suite

File Management

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

System Control

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

Nova AI Interface

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

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

User Password Role
operator admin Root / System Administrator
guest (none) Standard User

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/
    ├── /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

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: []
}
  1. Add a launcher to the dock or desktop in osStore.js.
  2. Ensure the component responds to Esc for window close.
  3. Use --glass-material and --accent-cyan tokens for styling.

🛰️ Kernel Event Protocol

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

🎨 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

📋 Default VFS Manifest

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


⚙️ Kernel Configuration Examples

/etc/passwd

# 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

/etc/motd

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.

/home/operator/.bashrc

# 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

🔍 System Log Examples

Boot Log — sys.log

[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.

Authentication Log — auth.log

[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).

❓ 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

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

📑 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.

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

GitHub YouTube Live Demo


"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

Releases

No releases published

Packages

 
 
 

Contributors

Languages