🌐 VCA OS — Verified Card Authority & AI Autonomous Operating System

VCA OS is an operating system running directly inside the browser and backed by a direct Linux host IPC subsystem. It bridges Autonomous AI Multi-Agent Software Engineering, Real Host Process Execution, and Forensic Collectible Authentication & Optical Subgrade Intelligence (Verified Card Authority).

🔗 Live Application

https://vcacomputer.vercel.app/

📸 Operating System Preview

🛡️ Verified Card Authority (VCA) — Holographic Acrylic Slab & Digital Certificate

Physically-inspired collectible acrylic slab with tamper-evident holographic label, dynamic optical refraction, sub-millimeter subgrade intelligence, and on-chain NXP NFC cryptographic authentication.

🔮 Front Inspection — Gem Mint 9.5 Slab & Certificate	🔬 Back Inspection — Subgrades & Cryptographic Ledger

Alakazam EX • 2016 XY Fates Collide #125/124 `VCA-2026-125124` • NFC: `04:88:C1:25:12:40:99`	Official Subgrades: Center `9.5` • Corners `9` • Edges `9.5` • Surface `9` Hash: `0x7c9a2...4f8b` • On-Chain QR Verification

👤 Collector Profile & Cryptographic NFC Ledger

Verified collector profile featuring portfolio valuation, vault assets, live HUD scanner access, and cryptographic NXP NTAG424 DNA NFC chip tap resolution.

🌐 SlabBook — The Collector Social Network (OSSN v6.8)

Full-featured Open Source Social Network (OSSN) integrated directly into VCA OS, with the Pokémon Kanto League PokéBall theme, rich multi-media composer (photos, GIFs, YouTube videos, links), 3D interactive slab embeds, live grading sync, and collector guilds.

🏛️ System Architecture

🌟 Core System Capabilities

1. 🪟 Advanced Desktop Window Manager & Customization

Multi-Windowing Engine: Floating draggable windows with active z-index elevation, minimized trays, smooth maximize transitions, and snap zones (Left, Right, Full, Center).
Isolated Traffic Light Controls: Strict click containment preventing drag interference when closing, minimizing, or restoring windows.
Global System TopBar & Menu Tray: Real-time clock, CPU load gauges, memory allocation, workspace switcher, and single-click window tile/close commands.
Frosted Glass Dock & Global Command Palette: Quick-launch dock with magnification and unified Cmd/Ctrl + K command search for rapid navigation.
Dynamic Live Desktop Widgets Layer: Customizable desktop widgets for hardware telemetry, agent swarm queues, active notes, and memory tracking.
Side Tools & System Utilities Drawer: Right-edge slide-out drawer providing 1-click access to system monitors, active ports, hardware specs, and quick launchers.

2. ⚡ Autonomous AI Coding Agents Swarm

Full-Stack Autonomous Pipeline: Transforms natural language prompts into working full-stack applications with synthesized frontend components and backend Express routes.
Self-Healing AST Debugger: Continuously monitors backend runtime stderr logs, diagnoses syntax or missing npm module errors, and repairs broken code automatically.
Process & Port Supervisor: Automatically detects port collisions (e.g., allocating :3001 or :3002), spawns background processes, and establishes live preview iframe routing.
Human-in-the-Loop Security Gates: Built-in verification steps requiring explicit user approval before executing sensitive system or file-overwrite actions.

3. 🛡️ Verified Card Authority (VCA) Forensic Lab & Hardware Authentication

Sub-Millimeter Optical Subgrading: Multi-point computer vision inspection analyzing Centering (L/R and T/B ratios), Corner sharp radiuses, Edge wear/whitening, and Surface hologram sheen.
Physical NFC Slab Binding: Integrates with NTAG215 cryptographic chips via AES-128 key generation, permanently linking physical collectible slabs to tamper-proof digital certificates.
Live Market Valuation Sentinel: Real-time auction volatility analyzer aggregating recent sales data across major auction registries with historical trend charts.
3D Holographic Slab Visualizer: Interactive 3D rendered card slabs with real-time lighting reflection and grade certification breakdown.

4. 🐚 Direct Host Linux IPC & Interactive Shell Subsystem

Real Interactive Terminal: Full bash shell integration backed by Node.js child_process runtime with process spawning and real-time streaming output.
Native Filesystem Operations: Atomic directory tree traversal, file creation, editing, deletion, and regex search across the workspace.
Live System Telemetry: Kernel metrics, CPU core utilization, memory heap monitoring, disk allocation, and active network ports.

5. 📦 Integrated Native Application Ecosystem

Application	Description
🛡️ VCA Forensics	Professional collectible grading lab, optical inspection, and NFC chip binding.
⬡ SlabBook (OSSN)	Open Source Social Network (v6.8) for card collectors with live grading sync, guilds, and rich media sharing.
👤 Collector Portal & NFC Ledger	Personal collector portfolio, real-time valuation, and hardware cryptographic NTAG424 DNA NFC resolution.
⚡ Coding Agents Lab	Autonomous multi-agent software engineering studio with live preview and debugger.
🐚 Terminal Shell	Direct Linux container terminal with package manager and git workflows.
📝 Code IDE	Full source code editor with syntax tree view, multi-file navigation, and execution.
📊 AI Slides Studio	AI-generated slide decks with live full-screen presentation mode.
🛍️ Extensions Marketplace	Curated registry of verified AI agents, forensic modules, and custom themes.
🔑 Encrypted Secrets Vault	AES-256-GCM zero-knowledge client secret and API key store.
📈 Observability & Audit Log	Immutable system event trace recording all agent and kernel actions.
📁 File Explorer	Desktop file manager with folder navigation, upload, download, and file inspection.
⚙️ Process Manager	Task manager displaying active PIDs, kill triggers, and CPU/RAM usage.
🌐 Browser & App Builder	In-OS sandboxed web browser and visual widget creator.
📄 Docs, Sheets & Mail	Native productivity suite with real-time editing and formula calculation.

🚀 Quick Start & Local Setup

Prerequisites

Node.js v20.0.0 or higher
npm or bun / yarn

1. Clone the Repository

git clone https://github.com/your-username/vca-os.git
cd vca-os

2. Install Dependencies

npm install

3. Configure Environment Variables

Copy .env.example to .env and provide your Google Gemini API key:

cp .env.example .env

Inside .env:

GEMINI_API_KEY=your_gemini_api_key_here

4. Launch the Development Server

npm run dev

Open your browser and navigate to:

http://localhost:3000

🛠️ Build & Production Deployment

To compile and bundle both the React frontend and the Express Node.js IPC server into a standalone production release:

# Compile frontend with Vite and bundle backend with esbuild
npm run build

# Start the compiled production server
npm run start

📁 Repository Structure

├── assets/                          # SVG UI previews, slab showcases, and architectural diagrams
│   ├── vca-card-slab-duo.jpg        # Front & Back dual slab inspection showcase
│   ├── vca-card-slab-front.svg      # Gem Mint 9.5 holographic front slab & certificate (vector)
│   ├── vca-card-slab-back.svg       # Official subgrades & cryptographic ledger back view (vector)
│   ├── vca-card-slab-front.png      # High-res front slab raster image
│   ├── vca-card-slab-back.png       # High-res back slab raster image
│   ├── vca-card-slab.jpg            # Standard front slab inspection asset
│   ├── vca-os-desktop-preview.svg   # Primary desktop workspace preview
│   ├── vca-os-architecture.svg      # Multi-agent & subsystem architecture diagram
│   ├── vca-user-profile-preview.svg # Collector profile & NFC ledger visual preview
│   └── vca-slabbook-preview.svg     # SlabBook OSSN social platform preview
├── src/
│   ├── App.tsx                      # Root Desktop Workspace & Layer Composer
│   ├── main.tsx                     # React 19 Client Entrypoint
│   ├── index.css                    # Tailwind CSS v4 styling rules
│   ├── components/
│   │   ├── apps/                    # Integrated Application Suite
│   │   │   ├── CodingAgentsApp.tsx  # Autonomous AI Coding Swarm Studio
│   │   │   ├── VCAApp.tsx           # Forensic Collectible Lab & 3D Slab
│   │   │   ├── SlabBookApp.tsx      # Open Source Social Network (OSSN) Collector Hub
│   │   │   ├── TerminalApp.tsx      # Linux Host Terminal Shell
│   │   │   ├── CodeApp.tsx          # Code IDE & Workspace Editor
│   │   │   ├── SlidesApp.tsx        # AI Slide Decks & Presentation Engine
│   │   │   ├── MarketplaceApp.tsx   # Verified Extension & Agent Store
│   │   │   ├── SecurityApp.tsx      # Encrypted Secret Key Vault
│   │   │   ├── ActivityApp.tsx      # Observability & Audit Event Trace
│   │   │   ├── ProcessManagerApp.tsx# Task & PID Activity Monitor
│   │   │   ├── FilesApp.tsx         # File System Explorer
│   │   │   ├── DocsApp.tsx          # Document Editor
│   │   │   ├── SheetsApp.tsx        # Spreadsheet Calculator
│   │   │   └── SettingsApp.tsx      # Wallpaper & System Preferences
│   │   ├── desktop/                 # Desktop OS Shell Components
│   │   │   ├── TopBar.tsx           # Menu Bar, Status Indicators & System Tray
│   │   │   ├── Dock.tsx             # Frosted Glass Application Launcher Dock
│   │   │   ├── WindowFrame.tsx      # Window Layout, Resize & Traffic Lights
│   │   │   ├── SideToolsPanel.tsx   # Side Utility Drawer & Telemetry Sentinel
│   │   │   ├── DesktopWidgets.tsx   # Live Floating Desktop Information Cards
│   │   │   ├── DesktopIcons.tsx     # Desktop Shortcuts Grid
│   │   │   ├── CommandPalette.tsx   # Cmd/Ctrl+K Quick Search
│   │   │   ├── NotificationCenter.tsx # OS Notifications & Approval Toasts
│   │   │   └── QuickSettings.tsx    # Audio, Display, Network & Mode Toggles
│   │   ├── public/                  # Public Collector Portals & Slabs
│   │   │   ├── UserPortal.tsx       # Collector Profile & Cryptographic NFC Ledger
│   │   │   └── PublicVerification.tsx # Public VCA Cert & QR Verification
│   │   └── engineering/             # Technology Registries & Hardware Bridge
│   ├── context/
│   │   ├── OSContext.tsx            # Global Windowing & Operating System State
│   │   └── VCAContext.tsx           # Forensic Grading & NFC Hardware State
│   └── types/
│       ├── os.ts                    # TypeScript Interfaces for Windows & Apps
│       └── vca.ts                   # Forensic Subgrade & Collectible Types
├── server.ts                        # Express IPC Server, Process & File APIs
├── server_ossn.ts                   # SlabBook OSSN backend endpoints & social data
├── server_pricing_api.ts            # Live market valuation & pricing adapters
├── server_scanner_api.ts            # High-res optical scanner bridge
├── server_vca_api.ts                # VCA certification & ledger endpoints
├── metadata.json                    # Application Manifest & Cloud Run Config
├── package.json                     # Project Dependencies & Build Scripts
├── tsconfig.json                    # Strict TypeScript Compiler Config
└── vite.config.ts                   # Vite 6 Bundler Configuration

🔒 Security & Sandboxing Standards

Zero-Knowledge Vault: API keys and tokens are stored encrypted and are never transmitted in cleartext over public networks.
Process Boundary Isolation: All command execution spawned by terminal or agent swarms runs within sandboxed cgroups with output sanitization.
Strict CORS & Iframe Policy: Dev servers and sub-previews bind exclusively to local loopback ports with strict origin validation.

📄 License

Distributed under the MIT License. See LICENSE for more information.

Name		Name	Last commit message	Last commit date
agent_tools		agent_tools
assets		assets
data		data
src		src
vca_projects		vca_projects
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
add-3js-to-slabbook.cjs		add-3js-to-slabbook.cjs
add-marketplace.cjs		add-marketplace.cjs
add-tabs.cjs		add-tabs.cjs
bun.lock		bun.lock
firebase-applet-config.json		firebase-applet-config.json
firebase-blueprint.json		firebase-blueprint.json
firestore.rules		firestore.rules
fix-3d-build.cjs		fix-3d-build.cjs
fix-bad-syntax-2.cjs		fix-bad-syntax-2.cjs
fix-bad-syntax-3.cjs		fix-bad-syntax-3.cjs
fix-bad-syntax-4.cjs		fix-bad-syntax-4.cjs
fix-bad-syntax.cjs		fix-bad-syntax.cjs
fix-comment-import.cjs		fix-comment-import.cjs
fix-dex-3d.cjs		fix-dex-3d.cjs
fix-imports-2.cjs		fix-imports-2.cjs
fix-imports-3.cjs		fix-imports-3.cjs
fix-imports-4.cjs		fix-imports-4.cjs
fix-imports-5.cjs		fix-imports-5.cjs
fix-imports.cjs		fix-imports.cjs
fix-last-lint.cjs		fix-last-lint.cjs
fix-lint-modals.cjs		fix-lint-modals.cjs
fix-missing-imports-2.cjs		fix-missing-imports-2.cjs
fix-missing-imports-3.cjs		fix-missing-imports-3.cjs
fix-missing-imports-last.cjs		fix-missing-imports-last.cjs
fix-missing-imports.cjs		fix-missing-imports.cjs
fix-react-import.cjs		fix-react-import.cjs
fix-slabbook-import.cjs		fix-slabbook-import.cjs
fix-state.cjs		fix-state.cjs
fix-three.cjs		fix-three.cjs
fix.cjs		fix.cjs
index.html		index.html
messenger-component.cjs		messenger-component.cjs
metadata.json		metadata.json
package-lock.json		package-lock.json
package.json		package.json
patch-engine-camera.cjs		patch-engine-camera.cjs
patch-slabbook-modals.cjs		patch-slabbook-modals.cjs
patch-slabbook.cjs		patch-slabbook.cjs
patch-vcaengine-2.cjs		patch-vcaengine-2.cjs
patch-vcaengine.cjs		patch-vcaengine.cjs
patch.cjs		patch.cjs
patch_conflict.cjs		patch_conflict.cjs
patch_mime.cjs		patch_mime.cjs
patch_models.cjs		patch_models.cjs
patch_recognition.cjs		patch_recognition.cjs
patch_recognition2.cjs		patch_recognition2.cjs
patch_registry.cjs		patch_registry.cjs
patch_silence.cjs		patch_silence.cjs
patch_silence2.cjs		patch_silence2.cjs
patch_threshold.cjs		patch_threshold.cjs
patch_toggle.cjs		patch_toggle.cjs
replace-suite.cjs		replace-suite.cjs
server.ts		server.ts
server_ossn.ts		server_ossn.ts
server_pricing_api.ts		server_pricing_api.ts
server_scanner_api.ts		server_scanner_api.ts
server_vca_api.ts		server_vca_api.ts
server_voice_agent.ts		server_voice_agent.ts
test-3js.cjs		test-3js.cjs
test-compile-status.cjs		test-compile-status.cjs
test-syntax.cjs		test-syntax.cjs
test_api.cjs		test_api.cjs
test_esbuild.cjs		test_esbuild.cjs
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Navigation Menu

Repository navigation

About

Repository files navigation

🌐 VCA OS — Verified Card Authority & AI Autonomous Operating System

🔗 Live Application

📸 Operating System Preview

🛡️ Verified Card Authority (VCA) — Holographic Acrylic Slab & Digital Certificate

👤 Collector Profile & Cryptographic NFC Ledger

🌐 SlabBook — The Collector Social Network (OSSN v6.8)

🏛️ System Architecture

🌟 Core System Capabilities

1. 🪟 Advanced Desktop Window Manager & Customization

2. ⚡ Autonomous AI Coding Agents Swarm

3. 🛡️ Verified Card Authority (VCA) Forensic Lab & Hardware Authentication

4. 🐚 Direct Host Linux IPC & Interactive Shell Subsystem

5. 📦 Integrated Native Application Ecosystem

🚀 Quick Start & Local Setup

Prerequisites

1. Clone the Repository

2. Install Dependencies

3. Configure Environment Variables

4. Launch the Development Server

🛠️ Build & Production Deployment

📁 Repository Structure

🔒 Security & Sandboxing Standards

📄 License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🌐 VCA OS — Verified Card Authority & AI Autonomous Operating System

🔗 Live Application

📸 Operating System Preview

🛡️ Verified Card Authority (VCA) — Holographic Acrylic Slab & Digital Certificate

👤 Collector Profile & Cryptographic NFC Ledger

🌐 SlabBook — The Collector Social Network (OSSN v6.8)

🏛️ System Architecture

🌟 Core System Capabilities

1. 🪟 Advanced Desktop Window Manager & Customization

2. ⚡ Autonomous AI Coding Agents Swarm

3. 🛡️ Verified Card Authority (VCA) Forensic Lab & Hardware Authentication

4. 🐚 Direct Host Linux IPC & Interactive Shell Subsystem

5. 📦 Integrated Native Application Ecosystem

🚀 Quick Start & Local Setup

Prerequisites

1. Clone the Repository

2. Install Dependencies

3. Configure Environment Variables

4. Launch the Development Server

🛠️ Build & Production Deployment

📁 Repository Structure

🔒 Security & Sandboxing Standards

📄 License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages