diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d3cf9cb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Post
+
+Some code to formalize parsing POST data and generating HTML forms.
+This is made as an attempt to de-duplicate code around generating forms with pre-existing data filled in.
+
+There is no templating included, the final step for HTML generation must be done by the parent application.
+An example parent application is given in `test.php`.
+
+Due to a lack of useful documentation, `test.php` is also the reference implementation.
+
+Testing is done by clicking around in `test.php`.
+
+# Dependencies
+
+- session_start() needs to be called from the parent application
+- openssl is required for CRSF token generation
+- class autoloading needs to be done from parent application