diff --git a/.assets/demo0.gif b/.assets/demo0.gif
new file mode 100644
index 0000000..7831cc8
Binary files /dev/null and b/.assets/demo0.gif differ
diff --git a/.assets/demo1.gif b/.assets/demo1.gif
new file mode 100644
index 0000000..946a271
Binary files /dev/null and b/.assets/demo1.gif differ
diff --git a/.assets/hui.svg b/.assets/hui.svg
new file mode 100644
index 0000000..524dd34
--- /dev/null
+++ b/.assets/hui.svg
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg version="1.1" viewBox="0 0 180 180" xmlns="http://www.w3.org/2000/svg">
+<circle cx="90" cy="90" r="90" fill="#f9f9f9" stroke-width="1.081"/>
+<circle cx="90" cy="90" r="83.28" fill="#000080"/>
+<path d="m96.15 141.6h-12.44v-75.76h12.44zm-26.01-96.26q0-3.675 1.979-5.23 1.979-1.696 4.664-1.696t4.664 1.696q1.979 1.555 1.979 5.23 0 3.534-1.979 5.371-1.979 1.696-4.664 1.696t-4.664-1.696q-1.979-1.837-1.979-5.371zm26.57 0q0-3.675 1.837-5.23 1.979-1.696 4.664-1.696 2.686 0 4.664 1.696 1.979 1.555 1.979 5.23 0 3.534-1.979 5.371-1.979 1.696-4.664 1.696-2.686 0-4.664-1.696-1.837-1.837-1.837-5.371z" fill="#f2f2f2" stroke-width="2.208" aria-label="ї"/>
+</svg>
diff --git a/README.md b/README.md
index 9147e84..e215fe6 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,26 @@
-# hUI (formerly kubi-ui)
-Simple reactive gui framework for games
+<img src="./.assets/hui.svg" width="110" align="left">
+<h1>
+  huї
+</h1>
+<div align="right">
+  <a href="./LICENSE.txt">
+    <img alt="license" src="https://img.shields.io/github/license/griffi-gh/hui" align="right">
+  </a><br>
+  <a href="https://crates.io/crates/hui">
+    <img alt="crates.io" src="https://img.shields.io/crates/v/hui.svg" align="right">
+  </a>
+</div>
+<p align="left">
+  Simple UI library for games and other interactive applications<br>
+  (formerly kubi-ui)
+</p>
+<br clear="all">
+
+<table>
+  <td>
+    <img src="./.assets/demo0.gif" width="300">
+  </td>
+  <td>
+    <img src="./.assets/demo1.gif" width="300">
+  </td>
+</table>