diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5f7b7bc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# base64
+A simple approach to convert strings from and to base64.
+Header only library.
+
+## Usage
+
+```cpp
+#include "base64.hpp"
+#include <iostream>
+
+int main() {
+  auto base64= to_base64("Hello, World!");
+  std::cout << base64 << '\n'; // SGVsbG8sIFdvcmxkIQ==
+  auto s = from_base64("SGVsbG8sIFdvcmxkIQ==");
+  std::cout << s << '\n'; // Hello, World!
+}
+```