From bb7d7c1163c391f9bb65a1488b3f9c2931d00fe7 Mon Sep 17 00:00:00 2001
From: Jorge Durban <jdurban@eshopworld.com>
Date: Mon, 1 Jun 2026 09:06:46 +0200
Subject: [PATCH] Document TinySuite sample

---
 README.md          |  1 +
 docs/tiny-suite.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 docs/tiny-suite.md

diff --git a/README.md b/README.md
index a77ac2c..c6aa591 100644
--- a/README.md
+++ b/README.md
@@ -185,6 +185,7 @@ TinyValidations is intentionally boring in the places that matter.
 - [Extending TinyValidations](docs/extending.md)
 - [TinyDispatcher integration](docs/tinydispatcher.md)
 - [MediatR integration](docs/mediatr.md)
+- [TinySuite and sample app](docs/tiny-suite.md)
 - [Architecture](docs/architecture.md)
 - [Roadmap](docs/roadmap.md)
 
diff --git a/docs/tiny-suite.md b/docs/tiny-suite.md
new file mode 100644
index 0000000..9e00efd
--- /dev/null
+++ b/docs/tiny-suite.md
@@ -0,0 +1,30 @@
+# TinySuite and the sample app
+
+TinyValidations is part of TinySuite, the small family of libraries made of TinyDispatcher, TinyValidations, and TinyEvents.
+
+Each package stays focused:
+
+- TinyValidations owns application input validation.
+- TinyDispatcher owns command and query execution.
+- TinyEvents owns reliable application-event handling through the outbox pattern.
+
+## TheTinyApplicationLayer sample
+
+The shared sample lives in the sibling `TheTinyApplicationLayer` repository.
+
+It is an ASP.NET Core and Blazor application that uses the three TinySuite NuGet packages together:
+
+```text
+Blazor Form
+-> API Endpoint
+-> TinyValidations
+-> TinyDispatcher
+-> Use Case
+-> TinyEvents Outbox
+-> Worker
+-> Event Consumer
+```
+
+TinyValidations appears before dispatch. It validates the incoming command and lets the handler run only when the command is valid. TinyDispatcher then executes the use case, and TinyEvents records the durable side effect.
+
+Use the sample when you want to see how TinyValidations fits with the rest of TinySuite in a real application shape rather than as an isolated package demo.