# sxo | Víctor García | Knowledge Base | Instagit

SXO is a multi-runtime server-side JSX tool for Node.js, Bun, Deno, and Cloudflare Workers. It includes SXOUI, a framework-agnostic UI library inspired by shadcn/ui

GitHub Stars: 49

Repository: https://github.com/gc-victor/sxo

---

## Articles

### [How to Optimize Production Builds with Custom esbuild Configuration in SXO](/gc-victor/sxo/optimize-production-builds-custom-esbuild-config)

Optimize SXO production builds using custom esbuild configuration. Inject any esbuild option via the BUILD environment variable to override defaults and enhance client-side bundling for better performance.

- Tags: performance
- Published: 2026-03-02

### [How to Add SXOUI Components Using the sxo add Command](/gc-victor/sxo/add-sxoui-components-sxo-add-command)

Learn to add SXOUI components to your project using the sxo add command. Effortlessly integrate UI elements from the basecoat library into your local src components directory.

- Tags: how-to-guide
- Published: 2026-03-02

### [SXO ETag and Caching: How Hashed vs Non-Hashed Assets Are Handled](/gc-victor/sxo/sxo-etag-caching-hashed-non-hashed-assets)

Learn how SXO manages ETag and caching for hashed vs non-hashed assets. Discover immutable year-long caches for hashed files and five-minute caches for others, optimizing performance.

- Tags: performance
- Published: 2026-03-02

### [How Middleware Execution Order Works in SXO's Middleware Chain](/gc-victor/sxo/middleware-execution-order-in-sxo)

Understand SXO middleware execution order in the middleware chain. Learn how SXO runs middleware sequentially and short-circuits the chain for efficient request processing. Optimize your SXO setup.

- Tags: internals
- Published: 2026-03-02

### [How the Readiness Probe Determines When the Dev Server Is Ready in SXO](/gc-victor/sxo/how-readiness-probe-determines-dev-server-ready)

Discover how the SXO readiness probe uses waitForHttp to poll the dev server's endpoint and determine readiness by checking status codes 200-499. Learn about backoff and jitter.

- Tags: internals
- Published: 2026-03-02

### [How to Deploy SXO to Cloudflare Workers with Wrangler Configuration](/gc-victor/sxo/deploy-sxo-to-cloudflare-workers-wrangler)

Deploy SXO to Cloudflare Workers using Wrangler. Configure ASSETS binding and map virtual imports in wrangler.jsonc for seamless static file serving and module management.

- Tags: how-to-guide
- Published: 2026-03-02

### [Node-Style vs Web Standard Middleware Signatures in SXO](/gc-victor/sxo/node-style-vs-web-standard-middleware-signatures)

Understand Node-style and Web Standard middleware signatures in SXO. Learn how SXO supports both Nodejs and serverless environments for flexible application development.

- Tags: deep-dive
- Published: 2026-03-02

### [How SXO Handles Static Asset Precompression (.br/.gz) Negotiation](/gc-victor/sxo/static-asset-precompression-negotiation)

Discover how SXO handles static asset precompression negotiation for .br/.gz files. SXO intelligently chooses between Brotli and Gzip based on client support and availability, optimizing load times.

- Tags: internals
- Published: 2026-03-02

### [What Runtime Helpers Does the Rust/WASM JSX Transformer Generate?](/gc-victor/sxo/rust-wasm-jsx-transformer-runtime-helpers)

Discover the three runtime helpers __jsxComponent __jsxSpread and __jsxList generated by the Rust WASM JSX transformer enabling efficient component rendering attribute serialization and list flattening.

- Tags: internals
- Published: 2026-03-02

### [How Route Parameter Validation Works with SLUG_REGEX in SXO](/gc-victor/sxo/route-parameter-validation-slug-regex)

Learn how SXO validates dynamic route parameters using SLUG_REGEX. Discover the compile-time and runtime checks that ensure correct URL patterns and prevent errors.

- Tags: how-to-guide
- Published: 2026-03-02

### [How SXO Detects Which JavaScript Runtime (Node, Bun, or Deno) Is Being Used](/gc-victor/sxo/sxo-runtime-detection-mechanism)

Discover how SXO identifies JavaScript runtimes like Node Bun or Deno by checking global objects Learn the simple detection method used in the gc Victor sxo repository.

- Tags: internals
- Published: 2026-03-02

### [How `global.css` Gets Injected Across All Routes in SXO](/gc-victor/sxo/how-global-css-gets-injected-across-routes)

Learn how SXO automatically injects your global CSS file into every route's entry points for consistent styling. Master your SXO build system.

- Tags: internals
- Published: 2026-03-02

### [How Per-Route Client Entries Work with the `clientDir` Configuration in SXO](/gc-victor/sxo/per-route-client-entries-clientdir-configuration)

Learn how SXO utilizes per-route client entries with the clientDir configuration to enable custom client-side bundles for each page during the esbuild pipeline.

- Tags: internals
- Published: 2026-03-02

### [What Security Protections Does SXO Provide Out of the Box?](/gc-victor/sxo/sxo-out-of-the-box-security-protections)

Discover SXO's built-in security protections like default HTTP headers, path traversal protection, and safe static file handling for automatic, hassle-free security.

- Tags: security
- Published: 2026-03-02

### [How to Configure Custom esbuild Loaders for Server Builds in sxo](/gc-victor/sxo/configure-custom-esbuild-loaders-server-builds)

Learn to configure custom esbuild loaders for server builds in sxo efficiently. Master CLI flags, env vars, and config files for seamless integration and highest precedence.

- Tags: how-to-guide
- Published: 2026-03-02

### [How SXO Resolves Configuration Precedence Between CLI Flags, Environment Variables, and Config Files](/gc-victor/sxo/sxo-configuration-precedence-flags-env-files)

Learn how SXO efficiently resolves configuration precedence. Discover its strict order for CLI flags, environment variables, and config files to ensure the first defined value wins.

- Tags: internals
- Published: 2026-03-02

### [How the `sxo generate` Command Works: Static Site Generation and Idempotency Explained](/gc-victor/sxo/how-sxo-generate-command-works-idempotent)

Understand how sxo generate creates static HTML, writing files to dist/client and using idempotency to skip already generated pages for faster builds.

- Tags: internals
- Published: 2026-03-02

### [SXO routes.json Manifest Structure and Asset Injection: A Complete Technical Guide](/gc-victor/sxo/routes-json-manifest-structure-and-asset-injection)

Understand SXO routes.json manifest structure and asset injection. Learn how URL paths map to modules and assets, with automatic CSS and JS injection in production.

- Tags: deep-dive
- Published: 2026-03-02

### [How SXO's Hot Reload Mechanism Works Internally: Server-Sent Events and DOM Swapping](/gc-victor/sxo/how-sxo-hot-reload-works-internally)

Explore SXO's hot reload: learn how Server-Sent Events update HTML and assets, swapping DOM content while keeping scroll position and state. Optimized for speed.

- Tags: internals
- Published: 2026-03-02

### [Generated vs Non-Generated Routes in SXO Production: A Technical Comparison](/gc-victor/sxo/difference-between-generated-and-non-generated-routes-production)

Understand generated vs non-generated routes in SXO production. Learn how generated routes offer static HTML with caching, while non-generated routes provide dynamic server-side rendering for every request.

- Tags: technical-comparison
- Published: 2026-03-02

### [How to Implement Authentication Middleware in SXO for Node, Bun, Deno, and Cloudflare Workers](/gc-victor/sxo/how-to-implement-authentication-middleware-in-sxo)

Implement authentication middleware in SXO for Node Bun Deno and Cloudflare Workers. Learn how to create cross-platform guards with SXOs standard middleware system.

- Tags: how-to-guide
- Published: 2026-03-02

### [How to Implement Custom 404 and 500 Error Pages in SXO](/gc-victor/sxo/how-to-implement-custom-404-and-500-error-pages-in-sxo)

Learn to implement custom 404 and 500 error pages in SXO by creating specific files in your pages directory. Improve user experience and site management.

- Tags: how-to-guide
- Published: 2026-03-02

### [How SXO Handles Dynamic Routing with Multiple Parameters: Inside the routeMatch Engine](/gc-victor/sxo/how-sxo-handles-dynamic-routing-with-multiple-parameters)

Learn how SXO manages dynamic routing with multiple parameters using its routeMatch engine. Discover its efficient regex caching and parameter mapping.

- Tags: internals
- Published: 2026-03-02