diff --git a/README.adoc b/README.adoc
deleted file mode 100644
index e69de29..0000000
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..86bb7ac
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# A calendar viewer in written in rust
+
+`calendar` is focused on displaying one or more files containing events in `ical` format
+
+it is currently in an early development phase.
+
+As a dependency, it requires the iced GUI repository to be cloned alongaside (see `Cargo.toml`)
+
+## supported views:
+
+* month view
+* year view
+
+## planned features
+
+* read ical events from a list of calendar files given as arguments
+* reload the events from a calendar file if the file changes
+* there is currently no plan to connect to a system calendar (e.g. evolution) or remote.