@archipelagoui/archipelago NPM

🏝 Archipelago CLI

Modular, edge-optimized frontend framework with secure VFS, post-quantum cryptography, and real-time hydration.

npm license

🚀 What is Archipelago?

Archipelago is a next-gen frontend framework designed for the edge.
It features JIT hydration, secure VFS layers, native post-quantum cryptography support, and a blazing fast CLI.

Think: Astro + Vite + Web Workers + Quantum Security — all in one.

✅ Completed Features

⚡ JIT Island Hydration (1 per frame)
🧠 Priority-based component queue
📦 Memory-safe virtual file system (VFS)
🔐 Encrypted VFS adapter
🌐 DTLS adapter with Kyber & Falcon (PQ crypto)
🧬 QuantumStream endpoint & HLS-ready streaming
🧩 JSX parser with template rendering
🧪 Fully automated CLI + CI + publish pipeline
💡 Devtools overlay for hydration insights

📦 Installation

pnpm add -D @archipelagoui/archipelago

Or run it globally:

npx archy-cli

🧩 CLI Usage

npx archy-cli create app my-app
npx archy-cli dev
npx archy-cli render src/pages/

🧪 Usage Examples

🔹 Render a single `.archy` file:

npx archy-cli render src/pages/about.archy

🔹 Hydrate all islands with debug mode:

npx archy-cli hydrate --debug

🔹 Serve VFS-backed site:

npx archy-cli serve

🔹 Start dev server:

npx archy-cli dev

🛠 CLI Commands

Command	Description
`create <type> <name>`	Scaffold app, page, component, plugin, store
`render <input>`	Render a `.archy` file or folder
`hydrate`	Start hydration engine in the browser
`serve`	Launch VFS + Stream + API server
`dev`	Start dev server
`build`	Compile for production
`start`	Preview built project
`verify`	Validate project integrity
`pre-compile`	Run JSX stub + import map generation
`history`	View CLI command history

🔄 Version Management

This project uses a .version file and sync-versions.mjs script to:

Bump the patch version
Sync all package.json files
Trigger auto-publish via GitHub Actions

node sync-versions.mjs
pnpm publish

🧪 Roadmap

CLI scaffolding and VFS integration
DTLS + PQ crypto adapters (Kyber, Falcon)
Priority queue hydration system
Devtools overlay and diagnostics
Stream + verify endpoints
Component graph visualization
IPFS & LoRa-compatible VFS layer

📁 Project Structure

.
├── components/            # Archipelago .archy UI islands
├── core/                  # Hydration runtime, registry, crypto, VFS
├── scripts/               # Utilities (e.g., sync-versions.mjs)
├── .version               # Global version anchor
├── dist/                  # Compiled CLI and runtime output
└── package.json