diff --git a/.cspell/custom-words.txt b/.cspell/custom-words.txt
new file mode 100644
index 000000000..1f2c42590
--- /dev/null
+++ b/.cspell/custom-words.txt
@@ -0,0 +1,8 @@
+agent-centricity
+Anwaar
+Burmeister
+CRDT
+d'Aoust
+IPFS
+Ulhaq
+Wahlstrom
diff --git a/.cspell/holochain-words.txt b/.cspell/holochain-words.txt
new file mode 100644
index 000000000..e9ecc5015
--- /dev/null
+++ b/.cspell/holochain-words.txt
@@ -0,0 +1,12 @@
+hApp
+Holo
+Holo's
+Holochain
+Holochain's
+Holonix
+Tryorama
+webhapp
+zome
+zome's
+zomes
+zomes'
\ No newline at end of file
diff --git a/.cspell/template-words.txt b/.cspell/template-words.txt
new file mode 100644
index 000000000..66aff105d
--- /dev/null
+++ b/.cspell/template-words.txt
@@ -0,0 +1,11 @@
+brower
+coreconcepts
+elif
+endfor
+endlink
+endmacro
+endrenderlayoutblock
+newblock
+renderlayoutblock
+storysequence
+surpress
diff --git a/.cspell/words-that-should-exist.txt b/.cspell/words-that-should-exist.txt
new file mode 100644
index 000000000..836c6b430
--- /dev/null
+++ b/.cspell/words-that-should-exist.txt
@@ -0,0 +1,13 @@
+affordance
+affordances
+counterparties
+counterparties'
+counterparty
+counterparty's
+filesystem
+filesystems
+permissivity
+todo
+todos
+unforgeable
+unvalidated
\ No newline at end of file
diff --git a/cspell.json b/cspell.json
new file mode 100644
index 000000000..82e873583
--- /dev/null
+++ b/cspell.json
@@ -0,0 +1,21 @@
+{
+    "dictionaries": ["holochain", "words-that-should-exist", "custom", "template"],
+    "dictionaryDefinitions": [
+        {
+            "name": "holochain",
+            "path": "./.cspell/holochain-words.txt"
+        },
+        {
+            "name": "words-that-should-exist",
+            "path": "./.cspell/words-that-should-exist.txt"
+        },
+        {
+            "name": "custom",
+            "path": "./.cspell/custom-words.txt"
+        },
+        {
+            "name": "template",
+            "path": "./.cspell/template-words.txt"
+        }
+    ]
+}
\ No newline at end of file