itsi 0.2.15 → 0.2.17

data/docs/benchmark-dashboard/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "my-v0-project",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "vite build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^3.9.1",
+    "@radix-ui/react-accordion": "1.2.2",
+    "@radix-ui/react-alert-dialog": "1.1.4",
+    "@radix-ui/react-aspect-ratio": "1.1.1",
+    "@radix-ui/react-avatar": "1.1.2",
+    "@radix-ui/react-checkbox": "1.1.3",
+    "@radix-ui/react-collapsible": "1.1.2",
+    "@radix-ui/react-context-menu": "2.2.4",
+    "@radix-ui/react-dialog": "1.1.4",
+    "@radix-ui/react-dropdown-menu": "2.1.4",
+    "@radix-ui/react-hover-card": "1.1.4",
+    "@radix-ui/react-label": "2.1.1",
+    "@radix-ui/react-menubar": "1.1.4",
+    "@radix-ui/react-navigation-menu": "1.2.3",
+    "@radix-ui/react-popover": "1.1.4",
+    "@radix-ui/react-progress": "1.1.1",
+    "@radix-ui/react-radio-group": "1.2.2",
+    "@radix-ui/react-scroll-area": "1.2.2",
+    "@radix-ui/react-select": "2.1.4",
+    "@radix-ui/react-separator": "1.1.1",
+    "@radix-ui/react-slider": "1.2.2",
+    "@radix-ui/react-slot": "1.1.1",
+    "@radix-ui/react-switch": "1.1.2",
+    "@radix-ui/react-tabs": "1.1.2",
+    "@radix-ui/react-toast": "1.2.4",
+    "@radix-ui/react-toggle": "1.1.1",
+    "@radix-ui/react-toggle-group": "1.1.1",
+    "@radix-ui/react-tooltip": "1.1.6",
+    "@vitejs/plugin-react": "^4.5.0",
+    "autoprefixer": "^10.4.20",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "1.0.4",
+    "date-fns": "4.1.0",
+    "embla-carousel-react": "8.5.1",
+    "input-otp": "1.4.1",
+    "lucide-react": "^0.454.0",
+    "next": "15.2.4",
+    "next-themes": "^0.4.4",
+    "react": "^19",
+    "react-day-picker": "8.10.1",
+    "react-dom": "^19",
+    "react-hook-form": "^7.54.1",
+    "react-resizable-panels": "^2.1.7",
+    "recharts": "latest",
+    "sonner": "^1.7.1",
+    "tailwind-merge": "^2.5.5",
+    "tailwindcss-animate": "^1.0.7",
+    "vaul": "^0.9.6",
+    "vite": "^6.3.5",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "postcss": "^8",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5"
+  }
+}

data/docs/benchmark-dashboard/pnpm-lock.yaml

@@ -0,0 +1,5 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false

data/docs/benchmark-dashboard/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+  },
+};
+
+export default config;

data/docs/benchmark-dashboard/styles/globals.css

@@ -0,0 +1,94 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+body {
+  font-family: Arial, Helvetica, sans-serif;
+}
+
+@layer utilities {
+  .text-balance {
+    text-wrap: balance;
+  }
+}
+
+@layer base {
+  :root {
+    --background: 0 0% 100%;
+    --foreground: 0 0% 3.9%;
+    --card: 0 0% 100%;
+    --card-foreground: 0 0% 3.9%;
+    --popover: 0 0% 100%;
+    --popover-foreground: 0 0% 3.9%;
+    --primary: 0 0% 9%;
+    --primary-foreground: 0 0% 98%;
+    --secondary: 0 0% 96.1%;
+    --secondary-foreground: 0 0% 9%;
+    --muted: 0 0% 96.1%;
+    --muted-foreground: 0 0% 45.1%;
+    --accent: 0 0% 96.1%;
+    --accent-foreground: 0 0% 9%;
+    --destructive: 0 84.2% 60.2%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 89.8%;
+    --input: 0 0% 89.8%;
+    --ring: 0 0% 3.9%;
+    --chart-1: 12 76% 61%;
+    --chart-2: 173 58% 39%;
+    --chart-3: 197 37% 24%;
+    --chart-4: 43 74% 66%;
+    --chart-5: 27 87% 67%;
+    --radius: 0.5rem;
+    --sidebar-background: 0 0% 98%;
+    --sidebar-foreground: 240 5.3% 26.1%;
+    --sidebar-primary: 240 5.9% 10%;
+    --sidebar-primary-foreground: 0 0% 98%;
+    --sidebar-accent: 240 4.8% 95.9%;
+    --sidebar-accent-foreground: 240 5.9% 10%;
+    --sidebar-border: 220 13% 91%;
+    --sidebar-ring: 217.2 91.2% 59.8%;
+  }
+  .dark {
+    --background: 0 0% 3.9%;
+    --foreground: 0 0% 98%;
+    --card: 0 0% 3.9%;
+    --card-foreground: 0 0% 98%;
+    --popover: 0 0% 3.9%;
+    --popover-foreground: 0 0% 98%;
+    --primary: 0 0% 98%;
+    --primary-foreground: 0 0% 9%;
+    --secondary: 0 0% 14.9%;
+    --secondary-foreground: 0 0% 98%;
+    --muted: 0 0% 14.9%;
+    --muted-foreground: 0 0% 63.9%;
+    --accent: 0 0% 14.9%;
+    --accent-foreground: 0 0% 98%;
+    --destructive: 0 62.8% 30.6%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 14.9%;
+    --input: 0 0% 14.9%;
+    --ring: 0 0% 83.1%;
+    --chart-1: 220 70% 50%;
+    --chart-2: 160 60% 45%;
+    --chart-3: 30 80% 55%;
+    --chart-4: 280 65% 60%;
+    --chart-5: 340 75% 55%;
+    --sidebar-background: 240 5.9% 10%;
+    --sidebar-foreground: 240 4.8% 95.9%;
+    --sidebar-primary: 224.3 76.3% 48%;
+    --sidebar-primary-foreground: 0 0% 100%;
+    --sidebar-accent: 240 3.7% 15.9%;
+    --sidebar-accent-foreground: 240 4.8% 95.9%;
+    --sidebar-border: 240 3.7% 15.9%;
+    --sidebar-ring: 217.2 91.2% 59.8%;
+  }
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

data/docs/benchmark-dashboard/tailwind.config.ts

@@ -0,0 +1,96 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+    darkMode: ["class"],
+    content: [
+    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./app/**/*.{js,ts,jsx,tsx,mdx}",
+    "*.{js,ts,jsx,tsx,mdx}"
+  ],
+  theme: {
+  	extend: {
+  		colors: {
+  			background: 'hsl(var(--background))',
+  			foreground: 'hsl(var(--foreground))',
+  			card: {
+  				DEFAULT: 'hsl(var(--card))',
+  				foreground: 'hsl(var(--card-foreground))'
+  			},
+  			popover: {
+  				DEFAULT: 'hsl(var(--popover))',
+  				foreground: 'hsl(var(--popover-foreground))'
+  			},
+  			primary: {
+  				DEFAULT: 'hsl(var(--primary))',
+  				foreground: 'hsl(var(--primary-foreground))'
+  			},
+  			secondary: {
+  				DEFAULT: 'hsl(var(--secondary))',
+  				foreground: 'hsl(var(--secondary-foreground))'
+  			},
+  			muted: {
+  				DEFAULT: 'hsl(var(--muted))',
+  				foreground: 'hsl(var(--muted-foreground))'
+  			},
+  			accent: {
+  				DEFAULT: 'hsl(var(--accent))',
+  				foreground: 'hsl(var(--accent-foreground))'
+  			},
+  			destructive: {
+  				DEFAULT: 'hsl(var(--destructive))',
+  				foreground: 'hsl(var(--destructive-foreground))'
+  			},
+  			border: 'hsl(var(--border))',
+  			input: 'hsl(var(--input))',
+  			ring: 'hsl(var(--ring))',
+  			chart: {
+  				'1': 'hsl(var(--chart-1))',
+  				'2': 'hsl(var(--chart-2))',
+  				'3': 'hsl(var(--chart-3))',
+  				'4': 'hsl(var(--chart-4))',
+  				'5': 'hsl(var(--chart-5))'
+  			},
+  			sidebar: {
+  				DEFAULT: 'hsl(var(--sidebar-background))',
+  				foreground: 'hsl(var(--sidebar-foreground))',
+  				primary: 'hsl(var(--sidebar-primary))',
+  				'primary-foreground': 'hsl(var(--sidebar-primary-foreground))',
+  				accent: 'hsl(var(--sidebar-accent))',
+  				'accent-foreground': 'hsl(var(--sidebar-accent-foreground))',
+  				border: 'hsl(var(--sidebar-border))',
+  				ring: 'hsl(var(--sidebar-ring))'
+  			}
+  		},
+  		borderRadius: {
+  			lg: 'var(--radius)',
+  			md: 'calc(var(--radius) - 2px)',
+  			sm: 'calc(var(--radius) - 4px)'
+  		},
+  		keyframes: {
+  			'accordion-down': {
+  				from: {
+  					height: '0'
+  				},
+  				to: {
+  					height: 'var(--radix-accordion-content-height)'
+  				}
+  			},
+  			'accordion-up': {
+  				from: {
+  					height: 'var(--radix-accordion-content-height)'
+  				},
+  				to: {
+  					height: '0'
+  				}
+  			}
+  		},
+  		animation: {
+  			'accordion-down': 'accordion-down 0.2s ease-out',
+  			'accordion-up': 'accordion-up 0.2s ease-out'
+  		}
+  	}
+  },
+  plugins: [require("tailwindcss-animate")],
+};
+export default config;

data/docs/benchmark-dashboard/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "target": "ES6",
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

data/docs/benchmark-dashboard/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import path from "node:path";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./"),
+    },
+  },
+  define: {
+    "process.env.NODE_ENV": JSON.stringify("production"),
+  },
+  build: {
+    lib: {
+      entry: "./embed.tsx",
+      name: "MyApp",
+      fileName: "benchmark-dashboard",
+      formats: ["iife"],
+    },
+    outDir: "dist",
+  },
+});

data/docs/build.rb

@@ -0,0 +1,52 @@
+require 'json'
+
+def replace_nans(obj)
+  case obj
+  when Array
+    obj.map { |e| replace_nans(e) }
+  when Hash
+    obj.transform_values { |v| replace_nans(v) }
+  when Float
+    obj.nan? ? 0.0 : obj
+  else
+    obj
+  end
+end
+
+system('cd benchmark-dashboard && '\
+  'npm run build && '\
+  'cp dist/benchmark-dashboard.iife.js ../static/scripts &&'\
+  'cp dist/benchmark-dashboard.css ../static/styles')
+
+combined = replace_nans(
+  Dir['../benchmarks/results/*'].map do |pth|
+    {
+      cpu: File.basename(pth),
+      groups: Dir["#{pth}/*"].map do |f|
+        {
+          group: File.basename(f),
+          tests: Dir["#{f}/*"].map do |f|
+            {
+              test: File.basename(f),
+              servers: Dir["#{f}/*.json"].map do |s|
+                {
+                  server: File.basename(s, '.json'),
+                  results: JSON.parse(IO.read(s), allow_nan: true)
+                }
+              end
+            }
+          end
+        }
+      end
+    }
+  end
+)
+
+IO.write(
+  './static/results.json',
+  combined.to_json
+)
+IO.write(
+  './public/results.json',
+  combined.to_json
+)

data/docs/content/benchmarks/index.md

@@ -0,0 +1,96 @@
+---
+title: "Benchmarks"
+description: "Performance benchmarks for Itsi across different devices and configurations"
+type: docs
+weight: 100
+toc: false
+sidebar:
+  exclude: true
+---
+
+<br/>
+<div id="root" style="min-height: 550px;">
+</div>
+
+<style>
+.hextra-toc{
+  width: 0 !important;
+}
+
+html{
+  scrollbar-gutter: stable;
+}
+</style>
+
+
+<link rel="stylesheet" href="/styles/benchmark-dashboard.css"/>
+
+<script>
+window.addEventListener("load", () => {
+  const script = document.createElement("script");
+  script.type = "text/javascript";
+  script.src="/scripts/benchmark-dashboard.iife.js";
+  document.body.appendChild(script);
+})
+</script>
+
+## Intro
+This benchmark suite tests a variety of the most widely used Rack servers, file servers, reverse proxies, and Ruby gRPC servers across diverse workloads on CPUs that vary significantly in their capabilities. Each benchmark includes error rates and p95 request latency.
+* AMD Ryzen 5600 (6 Core / 12 Thread). AMD64
+* Apple M1 Pro (6P cores + 2E cores). ARM64
+* Intel N97 (4 Cores). AMD64
+
+All tests were run on Ruby 3.4.3 with YJIT enabled.
+
+
+### Disclaimer
+All source code for these benchmarks is accessible [for review and reproduction](https://github.com/wouterken/itsi-server-benchmarks).
+
+While the intention is to fairly represent all software being tested, some results may not accurately reflect the best performance due to non-optimal configuration or errors in the test methodology. I welcome PRs to correct any such misconfiguration.
+
+Before using performance to rationalize a server switch, always measure first and confirm that server performance is actually a bottleneck for your workload.
+
+The following known caveats apply to these results:
+* **No isolated testing environment**: Benchmarks were run on personal development machines without measures to isolate CPU, memory, or disk I/O from background processes. This may introduce variability or skew in some results.
+* **Test clients and server were run on the same device**: Running both the load generator and the server on the same host introduces contention for CPU and memory resources. All network traffic occurs over the loopback interface, which does not reflect real-world network latency or congestion.
+* **No cooldown between concurrency sweeps**:  Concurrency tiers were tested sequentially on a single persistent server process, without a cooldown period between runs. Servers overloaded at high concurrency levels may exhibit degraded performance in subsequent tiers due to lingering backlog or thread exhaustion.
+* **Short test duration**: Each benchmark ran for only 3 seconds. This favors servers that perform well under cold start or burst conditions and may disadvantage those that rely on longer warm-up phases. This tradeoff was made intentionally to reduce the total benchmarking time and device occupation when generating large result sets.
+
+
+## Summary
+### Rack - Fast Handlers + Small Response Bodies
+These tests demonstrate the largest observed difference between pure-Ruby servers and native alternatives, because lightweight endpoints mean native servers spend almost all their time in optimized native code. However, this is rarely the case in true production workloads and is not a realistic indication of the performance impact you might see when switching to a more dynamic workload.
+Examples:
+* [Empty Response](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=empty_response&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Hello World](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=hello_world&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### Rack - Non-blocking
+Servers that support non-blocking IO (e.g., Falcon, Itsi) provide the best throughput for test cases that contain blocking operations, as they allow many more simultaneous requests to be multiplexed across fewer threads.
+As expected, performance differences narrow as we increase thread counts and workers for blocking servers.
+* [Chunked](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=chunked&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [IO heavy](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=io_heavy&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Non Blocking Big Delay](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=nonblocking_big_delay&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Non Blocking Small Delay](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=nonblocking_many_small_delay&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### Rack - Heavy CPU
+The above differences all but disappear on CPU-heavy workloads, as most time is spent bottlenecked in CPU-intensive code that behaves identically in all tests regardless of server implementation.
+* [CPU Heavy](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=cpu_heavy&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### Rack - Large Response Bodies
+When dealing with large bodies, much less time is spent in server code or Ruby handler code, and most performance impact results from how efficiently the server can flush bytes onto the network. Here, techniques like buffering and using vectored operations can reflect a throughput advantage.
+* [Response Size Large](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=response_size_large&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### Mixed Workload (Static + Dynamic)
+A mixed workload test, requesting an image, a static HTML file, and a dynamic endpoint simultaneously aiming to represent more realistic and varied production workloads. This benchmark demonstrates the advantage of the typical production Ruby app server deployment, fronted by a reverse proxy, as an efficient alternative to serving static assets directly from an app server, where static asset requests are subject to head-of-line blocking. This test also compares this traditional setup to an alternative: using an all-in-one solution like Itsi, which serves static assets from an separate asynchronous reactor, isolated from Ruby worker threads to provide equivalent or better performance, without needing to spin up a dedicated proxy process.
+* [Static Dynamic Mixed](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=static_dynamic_mixed&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### File Serving
+Native servers and reverse proxies offer the best file-serving performance as they can do this at incredible speeds without contending for the GVL.
+* [Static Large](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=static_large&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Static Small](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=static_small&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+
+### gRPC
+The server bundled with the Ruby [gRPC gem](https://github.com/grpc/grpc/tree/master/src/ruby) is the de facto standard for gRPC services in the Ruby ecosystem. However, it doesn't utilize a Fiber scheduler and therefore is more prone to thread exhaustion errors, particularly for streaming calls, than Itsi.
+* [Echo Stream](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=echo_stream&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Process Payment](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=process_payment&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)
+* [Echo Collect](?cpu=amd_ryzen_5_5600x_6_core_processor&testCase=echo_collect&threads=1&workers=1&concurrency=10&http2=all&xAxis=concurrency&metric=rps&visibleServers=agoo%2Cfalcon%2Citsi%2Cpuma%2Cpuma__caddy%2Cpuma__h2o%2Cpuma__itsi%2Cpuma__nginx%2Cpuma__thrust%2Cunicorn%2Ciodine%2Ccaddy%2Ch2o%2Cnginx%2Cgrpc_server.rb)

data/docs/content/features/_index.md

@@ -35,7 +35,7 @@ Pick and choose **just** the features that make sense for you.
 {{% /details %}}
 
 {{% details title="ETag and Cache Control" closed="true" %}}
-* Weak and Strong eTag support.
+* Weak and Strong ETag support.
 * `If-None-Match` and `If-Modified-Since` support.
 * Automated etag generation for dynamic content (or forwarding of existing `etags` if present)
 * See <a target="_blank" href="/middleware/etag">etag</a> and <a target="_blank" href="/middleware/cache_control">cache_control</a>

data/docs/content/getting_started/_index.md

@@ -15,67 +15,97 @@ Install Ruby
 
 ### Step 2 - Install Itsi
 
-{{< tabs items="Linux,Mac,Windows" >}}
+{{< tabs items="Linux,Mac,Windows,FreeBSD" >}}
   {{< tab >}}
   **Prerequisites**
 
-  You'll need at least `build-essential` and `libclang-dev` installed to build Itsi on Linux.
-  E.g.
-  ```bash
-  apt-get install build-essential libclang-dev
-  ```
 
-  Then use `gem` to install Itsi, or its components based on your Ruby version.
-
-  **For Ruby >= 3.0**:
-  ```bash
-  gem install itsi
-  ```
-  *(Installs both `itsi-server` and `itsi-scheduler`)*
-
-  **For Ruby 2.7**:
-  ```bash
-  gem install itsi-server
-  ```
-  *(Installs `itsi-server` only; `itsi-scheduler` is not supported on Ruby 2.7)*
-
-  {{< callout type="info" >}}
-  Itsi (**server + scheduler**) requires **Ruby >= 3.0**.
-
-  Itsi **server** supports **Ruby >= 2.7**.
-
-  If you wish to use either the scheduler or server independently:
-  - `gem install itsi-server`
-  - `gem install itsi-scheduler` (Ruby >= 3.0 only)
-  {{< /callout >}}
+You'll need at least a C/C++ build environment and `clang` and `curl` (for running `rustup`) installed.
+
+#### For Ubuntu / Debian:
+```bash
+    apt-get install build-essential libclang-dev curl
+```
+#### For Fedora / RHEL / Rocky / AlmaLinux:
+```bash
+    dnf groupinstall "Development Tools"
+    dnf install clang curl
+```
+#### For Arch Linux / Manjaro:
+```bash
+    pacman -S base-devel clang curl
+```
+#### For Alpine Linux:
+```bash
+    apk add build-base clang curl
+```
+
+Then use `gem` to install Itsi, or its components based on your Ruby version.
+
+**For Ruby >= 3.0**:
+```bash
+    gem install itsi
+```
+*(Installs both `itsi-server` and `itsi-scheduler`)*
+
+**For Ruby 2.7**:
+```bash
+    gem install itsi-server
+```
+*(Installs `itsi-server` only; `itsi-scheduler` is not supported on Ruby 2.7)*
+
+> ℹ️ **Itsi (`server` + `scheduler`) requires Ruby >= 3.0**
+> Itsi `server` supports Ruby >= 2.7
+> You can install components individually:
+> `gem install itsi-server`
+> `gem install itsi-scheduler` (Ruby >= 3.0 only)
 
   {{< /tab >}}
   {{< tab >}}
   **Mac**:
   **For Ruby >= 3.0**:
-  ```bash
-  gem install itsi
-  ```
+```bash
+    gem install itsi
+```
+*(Installs both `itsi-server` and `itsi-scheduler`)*
+
+**For Ruby 2.7**:
+```bash
+    gem install itsi-server
+```
+*(Installs `itsi-server` only; `itsi-scheduler` is not supported on Ruby 2.7)*
+
+> ℹ️ **Itsi (`server` + `scheduler`) requires Ruby >= 3.0**
+> Itsi `server` supports Ruby >= 2.7
+> You can install components individually:
+> `gem install itsi-server`
+> `gem install itsi-scheduler` (Ruby >= 3.0 only)
+  {{< /tab >}}
+  {{< tab >}}**Windows**: Itsi currently doesn't support native Windows builds, but it runs well on [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).
 
-  **For Ruby 2.7**:
-  ```bash
-  gem install itsi-server
-  ```
+  Follow the linked instructions to install a Linux distribution like Ubuntu or Debian, and then follow the instructions in the Linux tab.
+  {{< /tab >}}
+  {{< tab >}}
+  **FreeBSD**
 
-  {{< callout type="info" >}}
-  Itsi (**server + scheduler**) requires **Ruby >= 3.0**.
+On FreeBSD you'll need to install a few build tools manually:
+```bash
+  pkg install gmake cmake curl llvm
+```
 
-  Itsi **server** supports **Ruby >= 2.7**.
+Then install Itsi with GNU make to avoid build errors:
+```bash
+MAKE=gmake gem install itsi
+```
 
-  You can install components individually:
-  - `gem install itsi-server`
-  - `gem install itsi-scheduler` (Ruby >= 3.0 only)
-  {{< /callout >}}
+ *(Installs both `itsi-server` and `itsi-scheduler`)*
 
-  {{< /tab >}}
-  {{< tab >}}**Windows**: Itsi currently doesn't support native Windows builds, but it runs well on [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).
+**For Ruby 2.7**:
+```bash
+MAKE=gmake gem install itsi-server
+```
+*(Installs `itsi-server` only; `itsi-scheduler` is not supported on Ruby 2.7)*
 
-  Follow the linked instructions to install a Linux distribution like Ubuntu or Debian, and then follow the instructions in the Linux tab.
   {{< /tab >}}
 
 {{< /tabs >}}

data/docs/hugo.yaml

@@ -55,6 +55,9 @@ menu:
     - name: "Itsi Scheduler"
       pageRef: "/itsi_scheduler"
       weight: 2
+    - name: "Server Benchmarks"
+      pageRef: "/benchmarks"
+      weight: 2
     - name: "Github ↗"
       url: "https://github.com/wouterken/itsi"
       weight: 4