vixcpp · GaspardKirira · Mar 31, 2026 · Mar 31, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,110 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 
 ## [Unreleased]
+## [v2.1.0]
+
+This release focuses on performance, developer experience, and ecosystem maturity.
+
+Vix is no longer just fast.
+It is now structured, documented, and ready to be used in real projects.
+
+---
+
+### Performance
+
+- optimized HTTP hot path in core runtime
+- improved scheduler and task execution model
+- reduced overhead in run queue processing
+- optimized async coroutine fast-path
+- removed redundant error handling in async layer
+
+Result:
+- lower latency
+- better throughput
+- more predictable execution under load
+
+---
+
+### Templates
+
+- complete refactor of template examples
+- introduction of real-world use cases (dashboard, blog, marketing pages)
+- improved layout system (extends, includes, filters)
+
+New examples include:
+- shop dashboard
+- blog home and post pages
+- admin dashboards
+- marketing landing pages
+
+---
+
+### Documentation
+
+- massive addition of documentation across the entire ecosystem
+- new structured docs for:
+  - core modules
+  - async
+  - cache
+  - p2p and sync
+  - middleware and HTTP
+  - database and ORM
+- detailed real-world examples (auth, JWT, caching, rate limit, etc.)
+
+Result:
+- significantly improved onboarding
+- clearer mental model of Vix architecture
+- easier adoption for new developers
+
+---
+
+### Examples
+
+#### Added
+- structured template examples (01 → 12 progression)
+- new real-world scenarios across modules
+- improved consistency across all example categories
+
+#### Removed
+- removed outdated and legacy template examples
+- cleaned old and unstructured demo files
+
+---
+
+### Core & Modules
+
+- improvements across:
+  - core
+  - async
+  - template
+- better internal consistency and structure
+- improved maintainability for future features
+
+---
+
+### Developer Experience
+
+- examples now follow a progressive learning path
+- documentation aligned with real usage patterns
+- clearer separation between basic and advanced concepts
+
+---
+
+### Stability
+
+- improved runtime reliability
+- better performance under load
+- no breaking changes
+
+---
+
+### Summary
+
+v2.1.0 marks a major step toward making Vix a complete developer platform.
+
+From performance to documentation to real-world examples,
+Vix is now designed to be learned, used, and extended.
+
 ## [v2.0.0] - 2026-03-31
 
 Vix.cpp 2.0 starts here.

diff --git a/README.md b/README.md
@@ -1,71 +1,51 @@
 <table>
   <tr>
-    <td valign="top" width="70%">
+    <td valign="top" width="65%">
 
 <h1>Vix.cpp</h1>
 
 <p>
   <a href="https://x.com/vix_cpp">
-    <img src="https://img.shields.io/badge/X-Follow-black?logo=x" alt="X" />
+    <img src="https://img.shields.io/badge/X-Follow-black?logo=x" />
   </a>
   <a href="https://www.youtube.com/@vixcpp">
-    <img src="https://img.shields.io/badge/YouTube-Subscribe-red?logo=youtube" alt="YouTube" />
+    <img src="https://img.shields.io/badge/YouTube-Subscribe-red?logo=youtube" />
   </a>
-  <img src="https://img.shields.io/github/stars/vixcpp/vix?style=flat" alt="Stars" />
-  <img src="https://img.shields.io/github/forks/vixcpp/vix?style=flat" alt="Forks" />
-  <img src="https://img.shields.io/github/actions/workflow/status/vixcpp/vix/SECURITY_CI.yml?label=CI" alt="CI" />
 </p>
 
 <p>
-  <b>Vix.cpp</b> is a modern <b>C++ runtime</b> for building HTTP, WebSocket, and P2P applications with
-  <b>predictable performance</b>, <b>offline-first design</b>, and a
-  <b>Node/Deno-like developer experience</b>.
+  <b>A modern C++ runtime for real-world systems.</b>
 </p>
 
 <p>
-  🌍 <a href="https://vixcpp.com">vixcpp.com</a><br />
-  📘 <a href="https://vixcpp.com/docs">Documentation</a>
+  Build HTTP, WebSocket, and peer-to-peer applications with
+  <b>predictable performance</b> and <b>offline-first reliability</b>.
 </p>
 
-</td>
-    <td valign="middle" width="30%" align="right">
-      <img
-        src="https://res.cloudinary.com/dwjbed2xb/image/upload/v1762524350/vixcpp_etndhz.png"
-        alt="Vix.cpp Logo"
-        width="200"
-        style="border-radius:50%;"
-      />
-    </td>
-  </tr>
-</table>
-
-<hr />
-
-## Performance is not a feature it’s a requirement
+<p>
+  🌍 <a href="https://vixcpp.com">Website</a> ·
+  📘 <a href="https://vixcpp.com/docs">Docs</a> ·
+  ⬇️ <a href="https://github.com/vixcpp/vix/releases">Download</a>
+</p>
 
-Vix.cpp is designed to remove overhead, unpredictability, and GC pauses.
+</td>
 
-### ⚡ Benchmarks (Dec 2025)
+<td valign="middle" width="35%" align="right">
 
-| Framework                   | Requests/sec | Avg Latency |
-| --------------------------- | ------------ | ----------- |
-| ⭐ **Vix.cpp (pinned CPU)** | **~99,000**  | 7–10 ms     |
-| Vix.cpp (default)           | ~81,400      | 9–11 ms     |
-| Go (Fiber)                  | ~81,300      | ~0.6 ms     |
-| Deno                        | ~48,800      | ~16 ms      |
-| Node.js (Fastify)           | ~4,200       | ~16 ms      |
-| PHP (Slim)                  | ~2,800       | ~17 ms      |
-| FastAPI (Python)            | ~750         | ~64 ms      |
+<img
+  src="https://res.cloudinary.com/dwjbed2xb/image/upload/v1762524350/vixcpp_etndhz.png"
+  width="160"
+  style="border-radius:50%; object-fit:cover;"
+/>
 
-## Installation
+</td>
+  </tr>
+</table>
 
-Install the Vix runtime on your system using one of the commands below.
-Note that there are multiple ways to install Vix.
+## Install
 
 #### Linux
 
-**Ubuntu / Debian deps (example):**
-
 ```bash
 sudo apt update
 sudo apt install -y \
@@ -149,27 +129,64 @@ Run C++ like a script:
 
 ```bash
 vix run main.cpp
-vix dev main.cpp
 ```
 
-Vix handles compilation, linking, and execution automatically.
+Open http://localhost:8080
+
+## Why Vix.cpp
+
+Most systems assume perfect conditions.
+Vix is built for when things are not.
+
+- predictable under load
+- no GC pauses
+- offline-first by design
+- deterministic execution
+- minimal setup
+
+---
+
+## Performance
+
+Stable under sustained load.
+
+| Metric        | Value          |
+|--------------|----------------|
+| Requests/sec | ~66k – 68k     |
+| Avg Latency  | ~13–20 ms      |
+| P99 Latency  | ~17–50 ms      |
+
+---
+
+## Core principles
+
+- Local-first execution
+- Network is optional
+- Deterministic behavior
+- Failure-tolerant
+- Built for unreliable environments
+
+---
 
 ## Learn more
 
-- 📘 Docs: https://vixcpp.com/docs
-- 🌍 Website: https://vixcpp.com
-- 📦 Registry: https://vixcpp.com/registry
-- 📦 Examples: https://vixcpp.com/docs/examples
+- Docs: https://vixcpp.com/docs
+- Registry: https://vixcpp.com/registry
+- Examples: https://vixcpp.com/docs/examples
+
 ---
 
 ## Contributing
 
 Contributions are welcome.
-If you care about modern C++, performance, and real-world reliability, you’ll feel at home here.
-Please read the contributing guide before opening a PR.
+
+### Focus areas
+
+- performance
+- reliability
+- networking
+- offline-first systems
 
 ---
 
-⭐ If this project resonates with you, consider starring the repository.
 MIT License
-