diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..a7da207
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,10 @@
+# Contributing
+
+Got Claude credits? Use them to make new items or whole new sections, then open a PR to add them to this public domain gallery. Editing or improving existing items is welcome too.
+
+- Each item is one script, `gen/<section>/<subject>/<action>.js`, served as `/<subject>/<action>.webp` and `.gif`
+- `npm run gen` renders new scripts into `public/`, `npm run gen -- cat/blink` re-renders one you changed
+- `npm run dev` to preview, the site builds with `npm run build` into `dist`
+- New section? Add its folder name to `sections` in `vite.config.js`
+- Improve items in place rather than renaming them, people hotlink the URLs
+- Everything you add is released under [CC0](LICENSE)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a4b3fd8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+<p align="center"><img src="https://vibegif.direct-img.link/cat/blink.webp" width="96" alt="blinking cat"></p>
+
+<h1 align="center">vibegif</h1>
+
+<p align="center">public domain gallery of gifs and animated webp<br><a href="https://vibegif.direct-img.link">vibegif.direct-img.link</a></p>
+
+Every file is CC0, hotlink away: `https://vibegif.direct-img.link/cat/blink.webp` (or `.gif`).
+
+```sh
+npm i
+npm run dev    # preview the gallery
+npm run gen    # render new gen/ scripts into public/
+npm run build  # site goes to dist/
+```
+
+Want to add some? See [CONTRIBUTING.md](CONTRIBUTING.md).