diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1615b40
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Kotlin Course
+
+This repository contains some examples and slides built
+with [reveal-md.js](https://github.com/webpro/reveal-md "link to the git repository of the reveal md project").
+To view the slides, the following command must be executed with
+the [node package manager (npm)](https://nodejs.org/en/download/package-manager/) [^1]:
+
+```bash
+npm install -g reveal-md
+```
+
+execute the following command:
+
+```bash
+reveal-md slides.md --theme league
+```
+
+[^1]: a tutorial for the installation can be found at the link above
\ No newline at end of file
diff --git a/reveal.json b/reveal.json
new file mode 100644
index 0000000..8942c8c
--- /dev/null
+++ b/reveal.json
@@ -0,0 +1,4 @@
+{
+  "controls": true,
+  "progress": true
+}
diff --git a/slides.md b/slides.md
new file mode 100644
index 0000000..449d994
--- /dev/null
+++ b/slides.md
@@ -0,0 +1,8 @@
+# Dezentrale Kotlin course
+
+## Kotlin language basics
+
+Kotlin is a...
+
+- multiplatform programming language
+- its penis is bigger as any other