PN Web OS Documentation

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

A full-featured command line interface with advanced scripting capabilities and privacy tools.

Manage your encrypted files with an intuitive GUI featuring drag & drop, file search, and recycle bin.

Real-time system monitoring with process management, resource usage tracking, and cleanup tools.

Real-time infrastructure monitoring with service health tracking, uptime statistics, and automated health checks for external services.

Comprehensive system configuration center for privacy, security, appearance, and data management.

Advanced development environment with Python REPL, WASM sandbox, and module loading capabilities.

Fast, lightweight text editor with syntax highlighting and multi-file support.

View and manipulate images with zoom, rotation, and basic filters.

Scientific calculator with history and keyboard shortcuts.

Encrypted note-taking app with rich text editing and Markdown support.

Privacy-focused web browser with built-in ad/tracker blocking and fingerprint protection.

End-to-end encrypted messaging with WebRTC peer-to-peer architecture.

Peer-to-peer video calling with screen sharing and multi-party support.

Fully decentralized peer-to-peer messaging with no server required.

Peer-to-peer file transfer using WebRTC data channels with no file size limits.

Browse and interact with the InterPlanetary File System (IPFS) for decentralized storage.

Blockchain explorer for Bitcoin and Ethereum with transaction lookup and address monitoring (read-only).

Comprehensive encrypted password manager with secure notes, credit cards, and password generation.

WebAssembly-powered integrated development environment for C, C++, and Rust with real-time compilation.

9.1 Core System Services (10)

9.2 Security & Cryptography Services (5)

9.3 Networking Services (6 active, 3 placeholder)

9.4 File Operations Services (6)

9.5 UI & Accessibility Services (9)

9.6 Advanced Services (4)

9.7 Infrastructure Services (3)

10.1 WebAssembly Compilation

Compile and execute C, C++, and Rust code directly in your browser using WebAssembly.

10.2 Peer-to-Peer Communications

WebRTC-based decentralized communication eliminating the need for centralized servers.

10.3 IPFS Integration

InterPlanetary File System integration for decentralized, immutable file storage.

10.4 Encryption & Privacy

Military-grade encryption and client-side security for maximum privacy.

10.5 Virtual Desktops

Multiple workspace support for organizing windows across different contexts.

PN Web OS implements a privacy-first 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

• • Do Not Track: DNT header sent with all requests
• • Auto-delete History: Configurable automatic history cleanup
• • No Telemetry: Zero data collection or transmission
• • Local-only Data: All data stays in browser (IndexedDB)
• • Encrypted Storage: All persistent data encrypted at rest

• • WCAG 2.1 AA: Accessibility compliance for all users
• • Privacy by Design: Privacy-first architecture from the ground up
• • GDPR-friendly: No personal data collection or processing
• • Browser Sandbox: Isolated execution environment security
• • Open Standards: WebRTC

Creating a New Application

To create a new application for PN Web OS:

1. Create a new component in /lib/webos/apps/
2. Implement the AppComponentProps interface
3. Register the app in the desktop applications array
4. Add appropriate icon and metadata

Application Template

'use client'

import { AppComponentProps } from '@/lib/webos/types'
import { useWebOS } from '@/lib/webos/context/WebOSContext'

export default function MyApp({ window }: AppComponentProps) {
  const webos = useWebOS()

  return (
    <div className="h-full bg-pn-gray-900">
      <h1 className="text-white p-4">My Application</h1>
    </div>
  )
}

Complete API Reference

WebOS Context Hook

Access WebOS services using the useWebOS() hook:

const webos = useWebOS()

// Access services
webos.fileSystem.readFile('/home/user/file.txt')
webos.notificationService.info('Hello World')
webos.windowManager.createWindow(myApp)

// Access user state
const { username, tier } = webos.user