From 4326328d78523d6933f7257ca0c9cbfa71b6cbb2 Mon Sep 17 00:00:00 2001
From: clover caruso <git@paperclover.net>
Date: Thu, 12 Feb 2026 22:22:37 -0800
Subject: [PATCH] chore: add a cuter example to the readme

---
 README.md | 32 +++++++++++++++++++++++++-------
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 2795417909ca63ed579994b260e2719207633d6b..7d4f0b77393fb7ce523dc9db153978bb212216d4 100644
--- a/README.md
+++ b/README.md
@@ -16,33 +16,51 @@ leveraging the existing ecosystem.
 > specification and there are likely implementation differences. Treat with
 > caution.
 
+Here's a glance at how things look. Complete example documents in <./examples>
+
 ````
 ---
+// in `clover` static site generator, `export const meta` powers meta and
+// open graph tags. frontmatter becomes exports and in-scope constants.
 meta:
   title: some interesting blog post
   description: i could be really interesting
   embed:
     image: /something/fire.png
 ---
+// this component will look for `blog-layout.marko`
 <blog-layout title=meta.title description=meta.description>
 
-i'm a catgirl and i love to **exist**. meow meow meow
+# ${meta.title}
 
-nyaa!!!!!
+i'm a catgirl and i love to **meow**! meow meow meow! 
 
 ```ts
-function yapfest() {
-  return 200;
+function doMyFavoriteThing() {
+  return "meow! ".repeat(Math.floor(Math.random() * 1000)).trim();
 }
 ```
 
-and then the demo of the above:
+## photos of my favorite people
 
-<include "./examples/01-first-example.marko" />
+i love using Marko components because they're extremely concise to write.
+a lot less brace hell for non-string attributes, and more treats!
+
+<photo-grid
+  base="/friends"
+  cols=[40, 30, 30]
+  rows=[300, 400, 200]
+>
+  <@img src="IMG_4831.jpeg" />
+  <@img src="IMG_4838.jpeg" w=2 />
+  <@img src="IMG_4839.jpeg" w=2 align="top" />
+  <@img src="IMG_4833.jpeg" h=2 />
+  <@img src="IMG_4832.jpeg" w=2 />
+</>
 
 ## in conclusion
 
-it's sweet
+i love being alive. ${'<3'} from ${new Date().getFullYear()}.
 
 </blog-layout>
 ````
-- 
2.54.0