diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aca9a91
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# Fsys - Filesystem Abstraction for Golang
+fsys is a package that abstracts the local and the s3 filesystem to try to provide a standard interface for both.
+
+[pkg.go.dev documentation](https://pkg.go.dev/egtyl.xyz/omnibill/fsys)
+
+## Examples
+*coming soon*
\ No newline at end of file