Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/shadownrx/windows/llms.txt

Use this file to discover all available pages before exploring further.

NEX OS is a next-generation computing experience built entirely for the web. It’s not a simple UI clone — it’s a full desktop ecosystem with 20+ integrated applications, a virtual file system, simulated package management, and real-time system monitoring powered by WebAssembly. Everything runs inside a single browser tab.

Quick Start

Clone the repo and have NEX OS running locally in under five minutes.

Architecture

Understand how the Window Manager, VFS, and context system work together.

API Reference

Hooks for windows, settings, file system, desktop, and UI state.

Built-in Apps

Explore the 20+ applications bundled with NEX OS.

What is NEX OS?

NEX OS simulates a complete operating system lifecycle — from UEFI firmware screen through POST, boot animation, login, and full desktop — entirely in the browser. It combines React 19’s reactive rendering with WebAssembly performance for CPU-intensive work, Three.js for real-time 3D backgrounds, and a micro-frontend architecture where every application runs in its own isolated context.

Window Manager

Drag, resize, snap, and z-index management for every open window.

Virtual File System

In-memory VFS with full CRUD — no real disk access required.

NEX Runtime

Simulated npm/pnpm and .nex executable support inside the Terminal.

WASM Engine

AssemblyScript and Rust modules running at near-native speed.

Neon Themes

Cyberpunk, Matrix, and Synthwave with live Three.js 3D backgrounds.

PWA Ready

Install NEX OS as a native app with offline support via vite-plugin-pwa.

Get Started

1

Clone and install

git clone https://github.com/shadownrx/windows.git
cd windows
npm install
2

Start the dev server

npm run dev
Open http://localhost:5173 in your browser. You’ll see the UEFI boot screen.
3

Build for production

npm run build
npm run preview
The production build compiles TypeScript, WASM modules, and bundles everything with Vite.
4

Build your first app

Create a component in src/components/apps/, register it in src/constants/apps.tsx, and it appears in the Start Menu automatically. See the Building Apps guide.

Technology Stack

TechnologyVersionPurpose
React19.xReactive UI and component model
TypeScript~5.9Strict typing across the entire codebase
Vite8.xBuild tooling with instant HMR
Tailwind CSS3.xUtility-first styling and design tokens
Framer Motion12.xWindow animations and transitions
Three.js / R3F0.183GPU-accelerated 3D backgrounds
AssemblyScript0.28TypeScript-like syntax compiled to WASM
RustWASM engine for system-level calculations
@fluentui/react-icons2.xFluent Design icon system
vite-plugin-pwa1.xPWA manifest and service worker

Build docs developers (and LLMs) love