Add book/ (mdbook based user guide)

1 files changed, 34 insertions, 0 deletions

diff --git a/book/src/install.md b/book/src/install.md
new file mode 100644
index 00000000..48813bee
--- /dev/null
+++ b/book/src/install.md
@@ -0,0 +1,34 @@
+# Installation
+
+TODO: Prebuilt binaries on GitHub Releases page
+
+## OSX
+
+TODO: brew tap
+
+```
+$ brew tap helix-editor/helix
+$ brew install helix
+```
+
+## Linux
+
+### NixOS
+
+A [flake](https://nixos.wiki/wiki/Flakes) containing the package is available in
+the project root. The flake can also be used to spin up a reproducible development
+shell for working on Helix.
+
+### Arch Linux
+
+TODO: AUR
+
+## Build from source
+
+```
+$ git clone --depth 1 --recurse-submodules -j8 https://github.com/helix-editor/helix
+$ cd helix
+$ cargo install --path helix-term
+```
+
+This will install the `hx` binary to `$HOME/.cargo/bin`.