diff --git a/cspell.config.yml b/cspell.config.yml
new file mode 100644
index 00000000..e76584ed
--- /dev/null
+++ b/cspell.config.yml
@@ -0,0 +1,50 @@
+$schema: https://raw.githubusercontent.com/streetsidesoftware/cspell/main/cspell.schema.json
+
+dictionaries:
+  - bash
+  - en_US
+  - filetypes
+  - misc
+  - node
+  - npm
+  - project-dictionary
+  - softwareTerms
+  - typescript
+
+dictionaryDefinitions:
+  - addWords: true
+    name: project-dictionary
+    path: ./project-dictionary.txt
+
+ignorePaths:
+  - .all-contributorsrc
+  - .git
+  - .gitattributes
+  - .github
+  - .gitignore
+  - .husky
+  - .lintstagedrc.yml
+  - .markdownlint.json
+  - .npmrc
+  - .prettierignore
+  - .prettierrc.yml
+  - .vscode
+  - CHANGELOG.md
+  - coverage
+  - cspell.config.yml
+  - docs/coverage.svg
+  - docs/generated
+  - lib
+  - node_modules
+  - pnpm-lock.yaml
+  - project-dictionary.txt
+
+ignoreRegExpList:
+  - /\b[A-Fa-f0-9]{6}\b/ # ignore hex color codes
+  - /\b[A-Za-z0-9]{32,}\b/ # ignore long string of hex characters
+  - /`[^`]*`/ # ignore things in `...`
+  - /```[\w\W]*?```/ # ignore things in ```...```
+
+language: en-US
+
+version: "0.2"
diff --git a/cspell.json b/cspell.json
deleted file mode 100644
index 839660cf..00000000
--- a/cspell.json
+++ /dev/null
@@ -1,38 +0,0 @@
-{
-	"dictionaries": ["typescript"],
-	"ignorePaths": [
-		".github",
-		"CHANGELOG.md",
-		"coverage",
-		"docs/coverage.svg",
-		"docs/generated",
-		"lib",
-		"node_modules",
-		"pnpm-lock.yaml"
-	],
-	"words": [
-		"ajafff",
-		"Codecov",
-		"codespace",
-		"commitlint",
-		"contributorsrc",
-		"conventionalcommits",
-		"freshable",
-		"infile",
-		"knip",
-		"konamimojisplosion",
-		"lcov",
-		"markdownlintignore",
-		"npmpackagejsonlintrc",
-		"outro",
-		"packagejson",
-		"phenomnomnominal",
-		"quickstart",
-		"tsquery",
-		"tsup",
-		"tsutils",
-		"tsvfs",
-		"typeguards",
-		"wontfix"
-	]
-}
diff --git a/package.json b/package.json
index d7bed137..1ed1b14a 100644
--- a/package.json
+++ b/package.json
@@ -41,7 +41,7 @@
 		"lint:md": "markdownlint \"**/*.md\" \".github/**/*.md\" --rules sentences-per-line",
 		"lint:package-json": "npmPkgJsonLint .",
 		"lint:packages": "pnpm dedupe --check",
-		"lint:spelling": "cspell \"**\" \".github/**/*\"",
+		"lint:spelling": "cspell lint --no-progress --show-suggestions --show-context --dot \"**\" \".github/**/*\"",
 		"prepare": "husky install",
 		"should-semantic-release": "should-semantic-release --verbose",
 		"test": "vitest",
diff --git a/project-dictionary.txt b/project-dictionary.txt
new file mode 100644
index 00000000..4a8d46f0
--- /dev/null
+++ b/project-dictionary.txt
@@ -0,0 +1,23 @@
+ajafff
+Codecov
+codespace
+commitlint
+contributorsrc
+conventionalcommits
+freshable
+infile
+knip
+konamimojisplosion
+lcov
+markdownlintignore
+npmpackagejsonlintrc
+outro
+packagejson
+phenomnomnominal
+quickstart
+tsquery
+tsup
+tsutils
+tsvfs
+typeguards
+wontfix
\ No newline at end of file