diff --git a/README.org b/README.org
new file mode 100644
index 0000000..24acd71
--- /dev/null
+++ b/README.org
@@ -0,0 +1,10 @@
+#+title: DoomThemes.jl
+#+author: tecosaur
+
+A port of the [[https://github.com/doomemacs/themes][Doom (Emacs) Theme megapack]] to Julia, using its =Face= system.
+
+* Usage
+
+#+begin_src julia-repl
+julia> DoomThemes.load(:theme_name)
+#+end_src