diff --git a/readme.org b/readme.org
new file mode 100644
index 0000000..73faa3a
--- /dev/null
+++ b/readme.org
@@ -0,0 +1,31 @@
+#+TITLE: min-percent zsh theme - a minimalist zsh theme with a % or # sign as the prompt terminator
+
+* Description
+Minimalist zsh theme with a % or # sign as the prompt terminator.
+
+Below is a screen shot demonstrating all of the possible prompt states (excluding when running as root user, where the „%” at the end of the prompt changes to „#”).
+
+[[./screen-shot.png]]
+
+* Prior art
+- The prompt is based on [[https://github.com/tobyjamesthomas/pi][pi.zsh-theme]] by [[https://github.com/tobyjamesthomas][Toby Thomas]].
+- the =get_pwd()= function is a modified version of one by [[https://github.com/shashankmehta][Shashank Mehta]].
+* Installation instructions
+** Requirements
+Error indicator is shown using a unicode emoji character - it was tested with Noto Color Emoji font. Git repository symbol uses Powerline glyph (0xe0a0) - make sure your monospace font can display it or change the character to your liking in the source.
+** Using zplug
+- Clone the repository to chosen location (assuming =~/Src/zsh-theme-min-percent=)
+- Add zplug directive to load theme:
+  #+begin_src shell
+    zplug "~/Src/zsh-theme-min-percent", use:"min-percent.zsh-theme", from:local, as:theme
+  #+end_src
+** Using oh-my-zsh
+- Clone the repository to chosen location (assuming =~/Src/zsh-theme-min-percent=)
+- Copy theme file so Oh-My-ZSH can find it:
+  #+begin_src shell
+    cp ~/Src/zsh-theme-min-percen/min-percent.zsh-theme ~/.oh-my-zsh/custom/themes/
+  #+end_src
+- Set theme in your =.zshrc=, before sourcing Oh-My-ZSH:
+  #+begin_src shell
+ZSH_THEME=min-percent
+  #+end_src
diff --git a/screen-shot.png b/screen-shot.png
new file mode 100755
index 0000000..0352e70
Binary files /dev/null and b/screen-shot.png differ