Enterprise-Grade Framework

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.

Stability Note

XyPriss has officially left its beta phase. This documentation is up-to-date for the stable v1.0 release.

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.

Static Delivery Peak

~13 100

req/s with Cluster ×10 — throughput leader against Express & Fastify.

0% Event Loop Blocked

Node.js is fully bypassed during file delivery.

Single-Worker Lead

×5 - ×8

Throughput advantage over Express/Fastify without cluster scaling.

Throughput (req/s) — Static Files

Concurrent connections

Higher is better

Full Benchmarks: routing, mixed workload, latency, p99 tail latency and error rates

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

Install XFPM & Requirements

curl -sL https://xypriss.nehonix.com/install.js | node

XFPM Exclusivity

All XyPriss projects MUST use xfpm for dependency management. npm/yarn/pnpm are not supported.

Next Steps

Proceed to the full installation guide to configure your development environment and deploy your first native binary.