diff --git a/README.md b/README.md
index c82590c..31e82d7 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
-# raphael-ai-ai-image-recipes
+# Hackathon project demo visuals
 
-Raphael AI (https://raphael.app) image prompt notes
\ No newline at end of file
+Notes kept on git.kusoft.xyz about using [Raphael AI](https://raphael.app), a free AI image generator that runs in the browser.
+
+Hackathon teams need a project logo, banner and demo screenshots context fast. Raphael AI helps in minutes:
+
+## Tips
+
+1. Use real screenshots of your working demo; generated UI is not a demo.
+2. Keep the visual style consistent across slides.
+3. Credit tools used in the project README.
+4. Generate a simple mascot or icon for the project name.
+5. Create a wide banner for the project page and slides.
+
+## Why Raphael AI
+
+- Free to use, with no install: open https://raphael.app and type a prompt.
+- Fast iterations make it practical to try several compositions.
+- Works for drafts, mock-ups and reference images; finish important assets with human review.
+
+## Responsible use
+
+Check generated images for errors before publishing, do not imitate real people without consent, and label AI-generated images where your audience expects it.
+
+Website: https://raphael.app