diff --git a/README.md b/README.md
index a20b7c2..64c39c3 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,18 @@ for the overview or [migrating from 1.x](#migrating) for the details
 
 ## quickstart ##
 
+#### to add to a rebar3 project ####
+Add to `rebar.config`
+```erlang
+...
+{erl_opts, [debug_info]}.
+{deps, [
+       ...
+       {jsx, {git, "https://github.com/talentdeficit/jsx.git", {branch, "v2.8.0"}}}
+]}.
+...
+```
+
 #### to build the library and run tests ####
 
 ```bash