diff --git a/README.md b/README.md
new file mode 100644
index 0000000..365f47a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+libvhdl
+=======
+A library of reusable components for VHDL designs and testbenches
+
+sim
+---
+(Non) synthesible components for testbenches
+
+test
+----
+Unit test for each component