@assetsart/nylon-mesh 1.0.1

package/docs/content/docs/index.mdx

@@ -0,0 +1,58 @@
+---
+title: Getting Started
+description: Install and run Nylon Mesh in under 2 minutes.
+---
+
+**Nylon Mesh** is a blazing-fast edge proxy built to solve the headaches of caching for modern SSR frameworks.
+
+## Why Nylon Mesh?
+
+Frameworks like **Next.js, Nuxt, React (SSR), Angular, and Vue** are powerful—but server-side rendering is computationally expensive. Running Node.js under heavy traffic without a dedicated caching layer leads to:
+
+- High CPU usage and slow TTFB
+- Potential crashes under traffic spikes
+- Complex custom caching logic inside your app
+
+**Nylon Mesh sits in front of your app.** It intercepts HTTP requests, caches the expensive SSR-generated HTML in RAM and Redis, and serves subsequent users instantly—dropping your backend load to near zero.
+
+## Installation
+
+Nylon Mesh is written in **Rust** for maximum performance. Compile and run directly:
+
+```bash
+cargo build --release
+```
+
+Or install via bun into your project:
+
+```bash
+bun add nylon-mesh
+```
+
+## Initialization
+
+Generate a ready-to-use configuration file:
+
+```bash
+bunx nylon-mesh init
+```
+
+This creates a `nylon-mesh.yaml` in your project folder. **No code changes required.**
+
+## Running the Proxy
+
+Start by pointing the proxy at your config:
+
+```bash
+cargo run --release -- nylon-mesh.yaml
+```
+
+Or via the CLI wrapper:
+
+```bash
+bunx nylon-mesh start nylon-mesh.yaml
+```
+
+<Callout title="🎉 You're all set!" type="info">
+Traffic hitting port `3000` (default) is now being cached and routed to your backend efficiently. Check out the [Configuration](/docs/configuration) to fine-tune your mesh.
+</Callout>

package/docs/content/docs/load-balancing.mdx

@@ -0,0 +1,69 @@
+---
+title: Load Balancing
+description: Configure upstream routing with round-robin, random, and weighted algorithms.
+---
+
+Nylon Mesh uses [Pingora's](https://github.com/cloudflare/pingora) production-proven load balancing engine to route incoming HTTP requests across your upstream pool.
+
+## Selection Algorithms
+
+| Algorithm | Behavior |
+|---|---|
+| `round_robin` **(default)** | Distributes traffic sequentially and equally across upstreams. |
+| `random` | Randomly assigns each request to an available upstream. |
+
+```yaml
+load_balancer_algo: "round_robin"
+```
+
+---
+
+## Defining Upstreams
+
+### Simple Configuration
+
+Just provide the address and port of each backend:
+
+```yaml
+upstreams:
+  - "127.0.0.1:3001"
+  - "127.0.0.1:3002"
+```
+
+### Weighted Configuration
+
+For backends with different hardware capabilities, assign `weight` to route proportionally more traffic:
+
+```yaml
+upstreams:
+  - address: "127.0.0.1:3001"
+    weight: 10
+  - address: "127.0.0.1:3002"
+    weight: 2
+```
+
+<Callout title="Tip" type="info">
+In this example, for every **12** requests the first server handles **10** while the second manages **2**. Use this to route more traffic to machines with stronger CPU/RAM.
+</Callout>
+
+---
+
+## Health Probes
+
+Integrated Liveness and Readiness endpoints for orchestration platforms like Kubernetes:
+
+```yaml
+liveness_path: "/_health/live"
+readiness_path: "/_health/ready"
+grace_period_seconds: 0
+graceful_shutdown_timeout_seconds: 0
+```
+
+| Probe | Path | Behavior |
+|---|---|---|
+| **Liveness** | `/_health/live` | Returns `200 OK` while the proxy process is healthy. |
+| **Readiness** | `/_health/ready` | Returns `200 OK` when ready to receive traffic. Returns `503` during graceful shutdown to drain connections. |
+
+<Callout title="Warning" type="warn">
+Health probe paths are handled natively by Nylon Mesh and **never** forwarded to your backend. Make sure these paths don't conflict with your application routes.
+</Callout>

package/docs/content/docs/meta.json

@@ -0,0 +1,9 @@
+{
+  "title": "Documentation",
+  "pages": [
+    "index",
+    "caching",
+    "load-balancing",
+    "configuration"
+  ]
+}

package/docs/next.config.mjs

@@ -0,0 +1,11 @@
+import { createMDX } from 'fumadocs-mdx/next';
+
+const withMDX = createMDX();
+
+/** @type {import('next').NextConfig} */
+const config = {
+  reactStrictMode: true,
+  output: 'export',
+};
+
+export default withMDX(config);