diff --git a/.gitignore b/.gitignore
index ea8c4bf..40ed649 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1 @@
-/target
+docs/book
diff --git a/Cargo.lock b/Cargo.lock
new file mode 100644
index 0000000..95e5afd
--- /dev/null
+++ b/Cargo.lock
@@ -0,0 +1,7 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "okrust"
+version = "0.1.0"
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..277780e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+
+
+# okRust
+
+okrust is the template for new rust projects within oknotok.computer.
+
+It has some opinionated defaults, like using:
+- mdBook for documentation
+- release please for releases
+- github actions for CI/CD
diff --git a/book.toml b/book.toml
new file mode 100644
index 0000000..0c3c8c7
--- /dev/null
+++ b/book.toml
@@ -0,0 +1,5 @@
+[book]
+authors = ["sevki"]
+language = "en"
+multilingual = false
+src = "docs"
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
new file mode 100644
index 0000000..ae04977
--- /dev/null
+++ b/docs/src/SUMMARY.md
@@ -0,0 +1,3 @@
+# Summary
+
+- [Intro](intro.md)
diff --git a/docs/src/intro.md b/docs/src/intro.md
new file mode 100644
index 0000000..ee14a9d
--- /dev/null
+++ b/docs/src/intro.md
@@ -0,0 +1,10 @@
+# okRust
+
+
+
+okrust is the template for new rust projects within oknotok.computer.
+
+It has some opinionated defaults, like using:
+- mdBook for documentation
+- release please for releases
+- github actions for CI/CD
diff --git a/docs/src/okRust.png b/docs/src/okRust.png
new file mode 100644
index 0000000..938b3cd
Binary files /dev/null and b/docs/src/okRust.png differ