PN Web OS Documentation
A comprehensive guide to using PN's privacy-focused browser-based operating system
Table of Contents
Overview & Architecture
PN Web OS is a revolutionary browser-based operating system that prioritizes user privacy and security above all else. Built entirely with modern web technologies, it provides a full desktop experience without compromising your data.
Key Features
- • Zero Cloud Dependency: All data stays in your browser
- • End-to-End Encryption: AES-256 encryption for all stored data
- • No Telemetry: We never collect or transmit your data
- • Open Architecture: Built on standard web technologies
- • Portable: Works in any modern browser
System Architecture
┌─────────────────────────────────────────┐ │ PN Web OS Desktop │ ├─────────────────────────────────────────┤ │ ┌──────────┐ ┌──────────┐ ┌──────────┐│ │ │ Apps │ │ Services │ │ Core ││ │ │ │ │ │ │ ││ │ │ Terminal │ │ Window │ │ Auth ││ │ │ Files │ │ Manager │ │ State ││ │ │ Browser │ │FileSystem│ │ Types ││ │ │ Settings │ │ Notif. │ │ Utils ││ │ └──────────┘ └──────────┘ └──────────┘│ ├─────────────────────────────────────────┤ │ Browser Storage Layer │ │ IndexedDB | LocalStorage | Memory │ └─────────────────────────────────────────┘
Getting Started
1. First Login
When you first access PN Web OS, you'll be prompted to create a secure account:
- • Choose a strong password (minimum 8 characters)
- • Your password is used to derive encryption keys
- • All data is encrypted locally - we never see your password
2. Desktop Interface
The desktop provides a familiar interface with:
- • Taskbar: Access running apps and system functions
- • Start Menu: Launch applications and search
- • Desktop Icons: Quick access to frequently used apps
- • Notification Center: System alerts and updates
3. Window Management
Windows can be:
- • Dragged by their title bar
- • Resized from corners and edges
- • Minimized, maximized, or closed
- • Arranged using keyboard shortcuts
Core Applications
Terminal
A full-featured command line interface with:
- • File system navigation (cd, ls, pwd)
- • File operations (cat, mkdir, touch, rm)
- • Privacy tools (encrypt, decrypt, vpn status)
- • System information (ps, uname, date)
File Manager
Manage your encrypted files with:
- • Grid and list view modes
- • Drag & drop support
- • Encrypted file storage
- • Quick navigation breadcrumbs
Vault
Secure password manager featuring:
- • AES-256 encryption
- • Password generator
- • Secure notes & cards
- • Auto-lock protection
Messenger
End-to-end encrypted messaging:
- • E2E encryption for all messages
- • Contact public key verification
- • Message read receipts
- • Voice & video calls (planned for Q3 2026)
Browser
Privacy-focused web browser:
- • Built-in ad & tracker blocking
- • Automatic HTTPS upgrade
- • Fingerprint protection
- • Isolated cookie storage
Settings
System configuration center:
- • Privacy & security controls
- • Appearance customization
- • Network configuration
- • Data management
Security & Privacy
Zero-Knowledge Architecture
PN Web OS implements a true zero-knowledge architecture:
- • All encryption happens client-side in your browser
- • Your master password never leaves your device
- • We cannot access your data even if we wanted to
- • No cloud servers store your information
Encryption Standards
File Encryption
AES-256-GCM with PBKDF2 key derivation (100,000 iterations)
Message Encryption
End-to-end encryption using RSA-2048 for key exchange with AES-256 for message content
Password Storage
Encrypted vault with additional master password protection
File System & Encryption
The PN Web OS file system provides a secure, encrypted storage solution that runs entirely in your browser. All files are encrypted before storage and decrypted on-demand.
File System Structure
/
├── home/
│ └── user/
│ ├── Documents/
│ ├── Downloads/
│ ├── Pictures/
│ └── .config/
└── system/
└── apps/Terminal Commands
| Command | Description |
|---|---|
| ls | List directory contents |
| cd [dir] | Change directory |
| pwd | Print working directory |
| cat [file] | Display file contents |
| mkdir [name] | Create directory |
| touch [name] | Create file |
| rm [name] | Remove file or directory |
| encrypt [text] | Encrypt a message |
| decrypt [encrypted] | Decrypt a message |
| vpn | Show VPN status |
| privacy | Show privacy shield status |
Development Guide
Creating a New Application
To create a new application for PN Web OS:
- Create a new component in
/lib/webos/apps/ - Implement the
AppComponentPropsinterface - Register the app in the desktop applications array
- Add appropriate icon and metadata
Application Template
'use client'
import { AppComponentProps } from '@/lib/webos/types'
export default function MyApp({ window }: AppComponentProps) {
return (
<div className="h-full bg-pn-gray-900">
<h1 className="text-white p-4">My Application</h1>
</div>
)
}API Reference
fileSystem
Access the encrypted file system for reading/writing files
windowManager
Create and manage application windows
notificationService
Send system notifications to users
PN Web OS Documentation v1.0.0
Launch Web OS →