diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 0000000..39b37ef
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,21 @@
+name: documentation
+
+on:
+  push:
+    branches:
+      - master
+    tags: '*'
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: julia-actions/setup-julia@latest
+        with:
+          version: 'nightly'
+      - uses: julia-actions/julia-docdeploy@latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
diff --git a/.gitignore b/.gitignore
index ba39cc5..a0f2c77 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,3 @@
 Manifest.toml
+!docs/Manifest.toml
+/docs/build/
\ No newline at end of file
diff --git a/docs/Manifest.toml b/docs/Manifest.toml
new file mode 100644
index 0000000..ca29ef8
--- /dev/null
+++ b/docs/Manifest.toml
@@ -0,0 +1,106 @@
+# This file is machine-generated - editing it directly is not advised
+
+julia_version = "1.8.0-DEV.1301"
+manifest_format = "2.0"
+project_hash = "a8b3efa47a453bb1ea616ddad9b3bc811e2b2ddf"
+
+[[deps.ANSIColoredPrinters]]
+git-tree-sha1 = "574baf8110975760d391c710b6341da1afa48d8c"
+uuid = "a4c015fc-c6ff-483c-b24f-f7ea428134e9"
+version = "0.0.1"
+
+[[deps.Base64]]
+uuid = "2a0f44e3-6c83-55bd-87e4-b1978d98bd5f"
+
+[[deps.Dates]]
+deps = ["Printf"]
+uuid = "ade2ca70-3891-5945-98fb-dc099432e06a"
+
+[[deps.DocStringExtensions]]
+deps = ["LibGit2"]
+git-tree-sha1 = "b19534d1895d702889b219c382a6e18010797f0b"
+uuid = "ffbed154-4ef7-542d-bbb7-c09d3a79fcae"
+version = "0.8.6"
+
+[[deps.Documenter]]
+deps = ["ANSIColoredPrinters", "Base64", "Dates", "DocStringExtensions", "IOCapture", "InteractiveUtils", "JSON", "LibGit2", "Logging", "Markdown", "REPL", "Test", "Unicode"]
+git-tree-sha1 = "f425293f7e0acaf9144de6d731772de156676233"
+uuid = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+version = "0.27.10"
+
+[[deps.EscapeAnalysis]]
+deps = ["InteractiveUtils"]
+git-tree-sha1 = "2796651056e0030b8a79febf82b6d357cf014927"
+repo-rev = "avi/docs"
+repo-url = ".."
+uuid = "c6a77b2f-5d97-4bf0-b260-35fa9cc0f3d0"
+version = "0.0.0"
+
+[[deps.IOCapture]]
+deps = ["Logging", "Random"]
+git-tree-sha1 = "f7be53659ab06ddc986428d3a9dcc95f6fa6705a"
+uuid = "b5f81e59-6552-4d32-b1f0-c071b021bf89"
+version = "0.2.2"
+
+[[deps.InteractiveUtils]]
+deps = ["Markdown"]
+uuid = "b77e0a4c-d291-57a0-90e8-8db25a27a240"
+
+[[deps.JSON]]
+deps = ["Dates", "Mmap", "Parsers", "Unicode"]
+git-tree-sha1 = "8076680b162ada2a031f707ac7b4953e30667a37"
+uuid = "682c06a0-de6a-54ab-a142-c8b1cf79cde6"
+version = "0.21.2"
+
+[[deps.LibGit2]]
+deps = ["Base64", "NetworkOptions", "Printf", "SHA"]
+uuid = "76f85450-5226-5b5a-8eaa-529ad045b433"
+
+[[deps.Logging]]
+uuid = "56ddb016-857b-54e1-b83d-db4d58db5568"
+
+[[deps.Markdown]]
+deps = ["Base64"]
+uuid = "d6f4376e-aef5-505a-96c1-9c027394607a"
+
+[[deps.Mmap]]
+uuid = "a63ad114-7e13-5084-954f-fe012c677804"
+
+[[deps.NetworkOptions]]
+uuid = "ca575930-c2e3-43a9-ace4-1e988b2c1908"
+version = "1.2.0"
+
+[[deps.Parsers]]
+deps = ["Dates"]
+git-tree-sha1 = "d7fa6237da8004be601e19bd6666083056649918"
+uuid = "69de0a69-1ddd-5017-9359-2bf0b02dc9f0"
+version = "2.1.3"
+
+[[deps.Printf]]
+deps = ["Unicode"]
+uuid = "de0858da-6303-5e67-8744-51eddeeeb8d7"
+
+[[deps.REPL]]
+deps = ["InteractiveUtils", "Markdown", "Sockets", "Unicode"]
+uuid = "3fa0cd96-eef1-5676-8a61-b3b8758bbffb"
+
+[[deps.Random]]
+deps = ["SHA", "Serialization"]
+uuid = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
+
+[[deps.SHA]]
+uuid = "ea8e919c-243c-51af-8825-aaa63cd721ce"
+version = "0.7.0"
+
+[[deps.Serialization]]
+uuid = "9e88b42a-f829-5b0c-bbe9-9e923198166b"
+
+[[deps.Sockets]]
+uuid = "6462fe0b-24de-5631-8697-dd941f90decc"
+
+[[deps.Test]]
+deps = ["InteractiveUtils", "Logging", "Random", "Serialization"]
+uuid = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+
+[[deps.Unicode]]
+uuid = "4ec0a83e-493e-50e2-b9ac-8f72acf5a8f5"
diff --git a/docs/Project.toml b/docs/Project.toml
new file mode 100644
index 0000000..d21da2e
--- /dev/null
+++ b/docs/Project.toml
@@ -0,0 +1,3 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+EscapeAnalysis = "c6a77b2f-5d97-4bf0-b260-35fa9cc0f3d0"
diff --git a/docs/make.jl b/docs/make.jl
new file mode 100644
index 0000000..1ebb613
--- /dev/null
+++ b/docs/make.jl
@@ -0,0 +1,24 @@
+using EscapeAnalysis, Documenter
+
+let
+    local README = normpath(@__DIR__, "src", "index.md")
+    try
+        cp(normpath(@__DIR__, "..", "README.md"), README)
+        makedocs(; modules = [EscapeAnalysis],
+                   sitename = "EscapeAnalysis.jl",
+                   pages = Any["EscapeAnalysis" => "index.md"],
+                   format = Documenter.HTML(;
+                       prettyurls = get(ENV, "CI", nothing) == "true",
+                       ansicolor = true,
+                   ),
+                 )
+    catch err
+        rethrow(err)
+    finally
+        rm(README)
+    end
+end
+
+deploydocs(; repo = "github.com/aviatesk/EscapeAnalysis.jl.git",
+             push_preview = true,
+             )
diff --git a/docs/src/.gitkeep b/docs/src/.gitkeep
new file mode 100644
index 0000000..e69de29