commit 51521a57f9ecc4d6caae6c64f1388f76d303c1dc
Author: glyph <glyph@mycelial.technology>
Date:   Mon May 9 13:51:09 2022 +0200

    initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6c69ebb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# lykin
+
+_Symbiosis of SSB, key-value store and web server._
+
+## Introduction
+
+lykin is a tutorial application funded by a Secure Scuttlebutt (SSB) community grant. It is intended to showcase one way in which an SSB application can be written using the [golgi](http://golgi.mycelial.technology) client library. The application is not intended for widespread or longterm use and will not be maintained as such; it is purely for demonstration purposes. Anyone is free to fork the repository and use it as the basis for their own application.
+
+## Features
+
+lykin presents an email inbox-like UI and functions as a Scuttlebutt reader application. It allows the user to subscribe to peers and read the root posts of those peers. Individual posts can be marked as read or unread.
+
+A summary of the features:
+
+ - Subscribe to a peer (follow)
+ - Unsubscribe from a peer (unfollow)
+ - List subscribed peers
+ - List root posts for each peer
+ - Mark a post as read
+ - Mark a post as unread
+ - Fetch new posts
+
+## Design
+
+lykin has been built with the following components:
+
+ - [tera](https://crates.io/crates/tera)   : templating engine
+ - [rocket](https://crates.io/crates/rocket/0.5.0-rc.1) : web server
+ - [golgi](https://crates.io/crates/golgi)  : Scuttlebutt client library
+ - [sled](https://crates.io/crates/sled)   : transactional embedded database (key-value store)
+ - [sbot](https://github.com/cryptoscope/ssb)   : Scuttlebutt server (in our case, go-ssb)
+
+## Thanks
+
+I am grateful to the Butts who voted to fund this work, all contributors to the SSBC and Erick Lavoie in particular - both for partially funding this work and for developing and overseeing the community grant process.
+
+## Contact
+
+I can be reached via email: [glyph@mycelial.technology](mailto:glyph@mycelial.technology) or Scuttlebutt: `@HEqy940T6uB+T+d9Jaa58aNfRzLx9eRWqkZljBmnkmk=.ed25519`.
+
+## License
+
+TBD.