refactor(template): restructure examples with real-world use cases and organized views

- remove old basic template examples (filters, includes, loops, etc.)
- introduce structured examples with consistent naming (01–12)
- add real-world use cases:
  - shop dashboard
  - blog home and post page
  - documentation page
  - marketing landing page
  - admin dashboard
- add examples/views/ directory with layout, includes, and templates
- improve readability and learning progression from simple to advanced
- add examples/README.md for guidance

examples are now production-oriented and reflect real application patterns

Author: GaspardKirira

examples/01_render_basic.cpp

@@ -0,0 +1,50 @@
+/**
+ *
+ *  @file 02_loop_features.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/02_loop_features.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template file:
+//   examples/templates/views/02_loop/index.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/02_loop");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+            ctx.set("title", "Template Features");
+
+            vix::template_::Array features;
+            features.emplace_back("Blazing fast C++");
+            features.emplace_back("Template engine built-in");
+            features.emplace_back("Modern Jinja-style syntax");
+            features.emplace_back("Simple integration with App");
+
+            ctx.set("features", features);
+
+            res.render("index.html", ctx); });
+
+  app.run(8080);
+}

examples/02_loop_features.cpp

@@ -0,0 +1,44 @@
+/**
+ *
+ *  @file 03_if_else.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/03_if_else.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template file:
+//   examples/templates/views/03_if/index.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/03_if");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+            ctx.set("title", "Conditional Rendering");
+            ctx.set("logged_in", true);
+            ctx.set("user", "Gaspard");
+
+            res.render("index.html", ctx); });
+
+  app.run(8080);
+}

examples/03_if_else.cpp

@@ -0,0 +1,44 @@
+/**
+ *
+ *  @file 04_layout_extends.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/04_layout_extends.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template files:
+//   examples/templates/views/04_extends/base.html
+//   examples/templates/views/04_extends/index.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/04_extends");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+            ctx.set("title", "Template Inheritance");
+            ctx.set("user", "Gaspard");
+
+            res.render("index.html", ctx); });
+
+  app.run(8080);
+}

examples/04_layout_extends.cpp

@@ -0,0 +1,44 @@
+/**
+ *
+ *  @file 05_include_partial.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/05_include_partial.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template files:
+//   examples/templates/views/05_include/index.html
+//   examples/templates/views/05_include/header.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/05_include");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+            ctx.set("title", "Template Include");
+            ctx.set("user", "Gaspard");
+
+            res.render("index.html", ctx); });
+
+  app.run(8080);
+}

examples/05_include_partial.cpp

@@ -0,0 +1,50 @@
+/**
+ *
+ *  @file 06_filters_and_escape.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/06_filters_and_escape.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template file:
+//   examples/templates/views/06_filters/index.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/06_filters");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+            ctx.set("title", "Filters and Escaping");
+            ctx.set("name", "gaspard");
+            ctx.set("html", "<b>safe?</b>");
+
+            vix::template_::Array items;
+            items.emplace_back("C++");
+            items.emplace_back("HTTP");
+            items.emplace_back("Templates");
+            ctx.set("items", items);
+
+            res.render("index.html", ctx); });
+
+  app.run(8080);
+}

examples/06_filters_and_escape.cpp

@@ -0,0 +1,88 @@
+/**
+ *
+ *  @file 07_shop_dashboard.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2025, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+// Run:
+//   vix run examples/templates/07_shop_dashboard.cpp
+//
+// Then open:
+//   http://localhost:8080
+//
+// Expected template files:
+//   examples/templates/views/07_shop_dashboard/base.html
+//   examples/templates/views/07_shop_dashboard/header.html
+//   examples/templates/views/07_shop_dashboard/dashboard.html
+
+#include <vix.hpp>
+
+using namespace vix;
+
+int main()
+{
+  App app;
+  app.templates("./examples/templates/views/07_shop_dashboard");
+
+  app.get("/", [](Request &, Response &res)
+          {
+            vix::template_::Context ctx;
+
+            ctx.set("page_title", "Softadastra Shop Dashboard");
+            ctx.set("shop_name", "Softadastra Store");
+            ctx.set("owner_name", "Gaspard");
+            ctx.set("currency", "USD");
+            ctx.set("is_shop_open", true);
+            ctx.set("total_products", 128);
+            ctx.set("total_orders", 42);
+            ctx.set("monthly_revenue", 2450);
+
+            vix::template_::Array orders;
+
+            {
+              vix::template_::Object order;
+              order["id"] = "ORD-1001";
+              order["customer"] = "Alice";
+              order["status"] = "Paid";
+              order["amount"] = 120;
+              orders.emplace_back(order);
+            }
+
+            {
+              vix::template_::Object order;
+              order["id"] = "ORD-1002";
+              order["customer"] = "Bob";
+              order["status"] = "Pending";
+              order["amount"] = 75;
+              orders.emplace_back(order);
+            }
+
+            {
+              vix::template_::Object order;
+              order["id"] = "ORD-1003";
+              order["customer"] = "Charlie";
+              order["status"] = "Shipped";
+              order["amount"] = 210;
+              orders.emplace_back(order);
+            }
+
+            ctx.set("recent_orders", orders);
+
+            vix::template_::Array alerts;
+            alerts.emplace_back("2 products are low in stock");
+            alerts.emplace_back("1 order requires manual review");
+            ctx.set("alerts", alerts);
+
+            res.render("dashboard.html", ctx); });
+
+  app.run(8080);
+}