diff --git a/.gitattributes b/.gitattributes
index 937c0eb..da4a852 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,2 +1,3 @@
 /.yarn/releases/** binary
 /.yarn/plugins/** binary
+/assets/** binary
diff --git a/README.md b/README.md
index 3e743ff..ccfe766 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,23 @@
-# rss-reader
\ No newline at end of file
+# Yet Another RSS Reader (YARR) :pirate_flag:
+
+## Overview
+
+In a never-ending DIY quest, I've put together this RSS feed reader to keep up with the news. The main requirement
+observed here is to _not_ require any sort of backend (except for a serverless proxy to get around CORS) and to keep it
+all as simple as possible.
+
+<img src="./assets/overview.png"/>
+
+The reader allows the user to provide RSS feed URLs that should be pulled, settings and fetched results are cached using
+[browser local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage) if it's available. The
+results caching is also used to prevent refetches on load if the cache is fresh enough.
+
+The whole thing runs on [Netlify](https://www.netlify.com/)'s generous free tier.
+
+Feel free to use it for your own RSS needs and to [drop a word or
+two](https://github.com/mcataford/rss-reader/discussions/10) if you do. :tada:
+
+## Contributing
+
+The project welcomes contributions as long as they fit within the general roadmap, which is still TBD. Any contribution
+making the bundle smaller will be eagerly reviewed and celebrated as long as it preserves functionality.
diff --git a/assets/overview.png b/assets/overview.png
new file mode 100644
index 0000000..55a094d
Binary files /dev/null and b/assets/overview.png differ