Introduction to XyPriss
XyPriss is an Enterprise-Grade Hybrid Web Framework that combines the raw performance of compiled native binaries with the productivity and flexibility of TypeScript.
How XyPriss Works End-to-End
Every XyPriss app runs inside a Zero-Trust, multi-layer pipeline: the xfpm CLI launches your TypeScript runtime inside a libXESS memory vault, your app retrieves secrets safely via __sys__.__env__, builds routes and XyGuard policies in createServer(), and delegates networking and IPC to the native XHSC & libSynapx core on app.start().
xfpm dev / xfpm start resolves xypriss.config.jsonc, detects Bun/Node, and manages hot-reload.
Holds .env secrets in supervisor memory, shields process.env, and serves canary decoys on direct reads.
Verifies confinement on import and exposes caller-scoped secrets via get(), getStrict(), and withSecret().
Resolves &(env).KEY, mounts routers, XyGuard, XStatic, and isolated plugins.
Boots Single/XMS or Cluster workers, runs onServerReady hooks, and opens listeners.
Persistent multiplexed binary IPC between JS workers and the Go XHSC engine.
Hybrid Performance
Bridge compiled speed with developer velocity. Features XHSC Go-engine and XEMS encrypted storage.
Secure by Default
Native Environment Security Shield blocks direct `process.env` access to prevent sensitive data leakage.
Performance Snapshot
Real-world benchmarks show XyPriss leading on static delivery and maintaining stability under extreme load. Below is a quick look at the static file delivery pillar; the full suite includes routing and mixed workloads.
req/s with Cluster ×10 — throughput leader against Express & Fastify.
Node.js is fully bypassed during file delivery.
Throughput advantage over Express/Fastify without cluster scaling.
Throughput (req/s) — Static Files
Concurrent connections
Higher is better
System Architecture
At the center of XyPriss lies XHSC (XyPriss Hyper-System Core) — the native engine responsible for low-level HTTP networking, high-speed radix routing, and real-time telemetry.
1XHSC (Native Engine)
Handles HTTP/S stack, advanced radix routing, filesystem I/O, and hardware monitoring.
2Node.js Application Layer
The enterprise application layer for defining business logic, middleware, and processing pipelines.
3XFPM Package Manager
High-performance manager for ultra-fast dependency resolution and native core linking.
Mandatory Requirements
Using alternative package managers (npm, yarn, pnpm) or runtimes (node) to execute XyPriss projects may cause unexpected behavior and is not supported.
| Requirement | Purpose | Status |
|---|---|---|
| XFPM | Exclusively supported manager for installation and project execution. | MANDATORY |
| Bun | The JavaScript runtime required to execute the application layer. | MANDATORY |
Quick System Setup
curl -sL https://xypriss.nehonix.com/install.js | nodexfpm for dependency management. npm/yarn/pnpm are not supported.Proceed to the full installation guide to configure your development environment and deploy your first native binary.
