Add htmx example

build.sbt

@@ -198,8 +198,13 @@ lazy val unidocs = project
 // To avoid including this in the core build
 lazy val examples = project
   .in(file("examples"))
+  .enablePlugins(
+    KropTwirlLayout
+  )
   .settings(
     commonSettings,
+    // To avoid warn "unused import" for krop/examples/htmx/views/*.scala.html files
+    scalacOptions += "-Wconf:src=.*/views/html/.*:silent",
     moduleName := "krop-examples",
     mimaPreviousArtifacts := Set.empty,
     // This sets Krop into development mode, which gives useful tools for

docs/src/pages/directory.conf

@@ -9,4 +9,5 @@ laika.navigationOrder = [
   controller
   tools.md
   development.md
+  examples
 ]

docs/src/pages/examples/README.md

@@ -0,0 +1,6 @@
+# Examples
+
+The following examples demonstrate Krop in action, from a simple application to more advanced patterns. 
+They illustrate how Krop's design enables you to build everything from fast and scalable JSON APIs 
+to applications that serve static files, handle form data, compose routes, and use middleware for cross-cutting concerns like authorization. 
+These practical examples are here to help you see Krop's philosophy in practice and to serve as a starting point for your own projects. 

docs/src/pages/examples/directory.conf

@@ -0,0 +1,4 @@
+laika.navigationOrder = [
+  README.md
+  htmx.md
+]