diff --git a/.github/workflows/unit_tests.yaml b/.github/workflows/unit_tests.yaml
new file mode 100644
index 0000000..d7cdae0
--- /dev/null
+++ b/.github/workflows/unit_tests.yaml
@@ -0,0 +1,26 @@
+name: Run Neovim Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - uses: awalsh128/cache-apt-pkgs-action@latest
+        with:
+          packages: neovim
+          version: 1.0
+
+      - name: Run Lua Tests
+        env:
+          TMPDIR: ${{ runner.temp }}
+          TEMP: ${{ runner.temp }}
+        run: nvim --headless -l tests/run_tests.lua
+
diff --git a/.gitignore b/.gitignore
index fdd8d68..42e6967 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,4 @@
 vendor/plenary.nvim
 temp.json
+tests/**.actual
+tests/**.expected
diff --git a/lua/json-nvim/escaper.lua b/lua/json_nvim/escaper.lua
similarity index 65%
rename from lua/json-nvim/escaper.lua
rename to lua/json_nvim/escaper.lua
index d01a6f2..0b64273 100644
--- a/lua/json-nvim/escaper.lua
+++ b/lua/json_nvim/escaper.lua
@@ -1,5 +1,5 @@
-local jq = require("json-nvim.jq")
-local utils = require("json-nvim.utils")
+local jq = require("json_nvim.jq")
+local utils = require("json_nvim.utils")
 
 local function get_escaped_input(input)
     local compacted = jq.get_collapsed(input)
@@ -21,11 +21,23 @@ end
 
 local M = {}
 
+function M.escape_string(input)
+    local result = get_escaped_input(input)
+    assert(result and result ~= "", "escaped result was nil or empty")
+    return result
+end
+
+function M.unescape_string(input)
+    local result = get_unescaped_input(input)
+    assert(result and result ~= "", "unescaped result was nil or empty")
+    return result
+end
+
 function M.escape_file()
     local root = utils.get_treesitter_root()
 
     local content = utils.get_buffer_content_as_string()
-    local escaped = get_escaped_input(content)
+    local escaped = M.escape_string(content)
     utils.replace_tsnode_text(root, escaped)
 end
 
@@ -38,7 +50,7 @@ function M.unescape_file()
         return
     end
 
-    local unescaped = get_unescaped_input(content)
+    local unescaped = M.unescape_string(content)
     utils.replace_tsnode_text(root, unescaped)
 
     M.unescape_file()
diff --git a/lua/json-nvim/formatter.lua b/lua/json_nvim/formatter.lua
similarity index 82%
rename from lua/json-nvim/formatter.lua
rename to lua/json_nvim/formatter.lua
index f1b426f..bd0261d 100644
--- a/lua/json-nvim/formatter.lua
+++ b/lua/json_nvim/formatter.lua
@@ -1,5 +1,5 @@
-local jq = require("json-nvim.jq")
-local utils = require("json-nvim.utils")
+local jq = require("json_nvim.jq")
+local utils = require("json_nvim.utils")
 
 ---comment
 ---@param target_node TSNode
@@ -19,13 +19,15 @@ end
 
 local M = {}
 
+function M.format_string(json_string)
+    local result = jq.get_formatted(json_string)
+    assert(result and result ~= "", "minified result was nil or empty")
+    return result
+end
+
 function M.format_file()
     local content = utils.get_buffer_content_as_string()
-    local formatted = jq.get_formatted(content)
-    if formatted == nil or formatted == "" then
-        error("result was nil or empty")
-        return
-    end
+    local formatted = M.format_string(content)
     local replacement = utils.split(formatted, "\n\r")
 
     local root = utils.get_treesitter_root()
@@ -36,7 +38,7 @@ end
 ---@param input_json string
 ---@param target_node TSNode
 function M.format_and_put(input_json, target_node)
-    local formatted = jq.get_formatted(input_json)
+    local formatted = M.format_string(input_json)
     if formatted == nil or formatted == "" then
         error("result was nil or empty")
         return
diff --git a/lua/json-nvim/init.lua b/lua/json_nvim/init.lua
similarity index 94%
rename from lua/json-nvim/init.lua
rename to lua/json_nvim/init.lua
index 55a24d6..4e807c5 100644
--- a/lua/json-nvim/init.lua
+++ b/lua/json_nvim/init.lua
@@ -1,4 +1,4 @@
-local jn = require("json-nvim.json-nvim")
+local jn = require("json_nvim.json_nvim")
 
 local M = {}
 
diff --git a/lua/json-nvim/jq.lua b/lua/json_nvim/jq.lua
similarity index 64%
rename from lua/json-nvim/jq.lua
rename to lua/json_nvim/jq.lua
index b299c5d..3977ed3 100644
--- a/lua/json-nvim/jq.lua
+++ b/lua/json_nvim/jq.lua
@@ -1,17 +1,27 @@
-local utils = require("json-nvim.utils")
+local utils = require("json_nvim.utils")
 
-local temp_file_path = utils.get_plugin_root() .. "temp.json"
+local temp_file_path, os_file_sep = utils.get_os_temp_file_path()
 
-local function write_to_temp(input)
-    local f = io.open(temp_file_path, "w")
-    f:write(input)
+temp_file_path = temp_file_path .. os_file_sep .. "json_nvim_"
+
+--write data to a temporary file in plugin root
+---@param arg { input: string, operation: string }
+---@return string
+local function write_to_temp(arg)
+    if type(arg.input) ~= "string" then
+        error("no input to write_to_temp()")
+    end
+    local tmp_file = temp_file_path .. os.time() .. (arg.operation and ("-" .. arg.operation .. ".json") or ".json")
+    local f = io.open(tmp_file, "w")
+    f:write(arg.input)
     f:close()
+    return tmp_file
 end
 
 local M = {}
 
 ---get all keys from json text
----this function is used for scase_switching feature
+---this function is used for case_switching feature
 ---@param json string
 ---@return string[]
 function M.get_keys(json)
@@ -27,13 +37,12 @@ end
 function M.get_formatted(input)
     local result
     local cmd
+    local tmp_file = write_to_temp({ input = input, operation = "get_formatted" })
     if vim.fn.has("win32") == 1 then
-        write_to_temp(input)
-        cmd = "jq . " .. temp_file_path
+        cmd = "jq . " .. tmp_file
         result = vim.fn.system(cmd)
     else
-        write_to_temp(input)
-        cmd = "jq . -e " .. temp_file_path
+        cmd = "jq . -e " .. tmp_file
         result = vim.fn.system(cmd)
     end
 
@@ -46,14 +55,13 @@ end
 function M.get_collapsed(input)
     local result
     local cmd
+    local tmp_file = write_to_temp({ input = input, operation = "get_collapsed" })
     if vim.fn.has("win32") == 1 then
-        write_to_temp(input)
-        cmd = "jq -c . " .. temp_file_path
+        cmd = "jq -c . " .. tmp_file
         result = vim.fn.system(cmd)
         result = vim.fn.substitute(result, [[\n]], "", "g")
     else
-        write_to_temp(input)
-        cmd = "jq -c . " .. temp_file_path
+        cmd = "jq -c . " .. tmp_file
         result = vim.fn.system(cmd)
         result = result:gsub("\r?\n", "")
     end
@@ -67,14 +75,13 @@ end
 function M.get_rawed(input)
     local result
     local cmd
+    local tmp_file = write_to_temp({ input = input, operation = "get_rawed" })
     if vim.fn.has("win32") == 1 then
-        write_to_temp(input)
-        cmd = "jq -r . " .. temp_file_path
+        cmd = "jq -r . " .. tmp_file
         result = vim.fn.system(cmd)
         result = vim.fn.substitute(result, [[\n]], "", "g")
     else
-        write_to_temp(input)
-        cmd = "jq . -r " .. temp_file_path
+        cmd = "jq . -r " .. tmp_file
         result = vim.fn.system(cmd)
         result = result:gsub("[\n\r]", "")
     end
@@ -88,9 +95,9 @@ end
 function M.is_valid(input)
     local cmd
     local result
+    local tmp_file = write_to_temp({ input = input, operation = "is_valid" })
     if vim.fn.has("win32") == 1 then
-        write_to_temp(input)
-        cmd = "jq . -e " .. temp_file_path
+        cmd = "jq . -e " .. tmp_file
         result = vim.fn.system(cmd)
         local exit_status = vim.v.shell_error
 
@@ -98,8 +105,7 @@ function M.is_valid(input)
 
         return exit_status == 0
     else
-        write_to_temp(input)
-        cmd = "jq . -e " .. temp_file_path .. "</dev/null"
+        cmd = "jq . -e " .. tmp_file .. "</dev/null"
         result = vim.fn.system(cmd)
         local exit_status = vim.v.shell_error
 
diff --git a/lua/json-nvim/json-nvim.lua b/lua/json_nvim/json_nvim.lua
similarity index 96%
rename from lua/json-nvim/json-nvim.lua
rename to lua/json_nvim/json_nvim.lua
index 1f7efe7..27f9698 100644
--- a/lua/json-nvim/json-nvim.lua
+++ b/lua/json_nvim/json_nvim.lua
@@ -1,8 +1,8 @@
-local escaper = require("json-nvim.escaper")
-local formatter = require("json-nvim.formatter")
-local jq = require("json-nvim.jq")
-local minifier = require("json-nvim.minifier")
-local utils = require("json-nvim.utils")
+local escaper = require("json_nvim.escaper")
+local formatter = require("json_nvim.formatter")
+local jq = require("json_nvim.jq")
+local minifier = require("json_nvim.minifier")
+local utils = require("json_nvim.utils")
 
 ---sometimes buffer with valid json content is not
 ---set to `json` filetype, for example `log.log`
@@ -26,7 +26,7 @@ local function validate_and_set_buffer_filetype()
             end
 
             if choice ~= "y" then
-                print("json-nvim operation cancelled")
+                print("json_nvim operation cancelled")
             else
                 vim.bo.filetype = "json"
                 res = true
diff --git a/lua/json-nvim/minifier.lua b/lua/json_nvim/minifier.lua
similarity index 52%
rename from lua/json-nvim/minifier.lua
rename to lua/json_nvim/minifier.lua
index 152bb2f..f2ea6e0 100644
--- a/lua/json-nvim/minifier.lua
+++ b/lua/json_nvim/minifier.lua
@@ -1,16 +1,17 @@
-local jq = require("json-nvim.jq")
-local utils = require("json-nvim.utils")
+local jq = require("json_nvim.jq")
+local utils = require("json_nvim.utils")
 
 local M = {}
 
+function M.minify_string(json_string)
+    local result = jq.get_collapsed(json_string)
+    assert(result and result ~= "", "minified result was nil or empty")
+    return result
+end
+
 function M.minify_file()
     local content = utils.get_buffer_content_as_string()
-    local minified = jq.get_collapsed(content)
-    if minified == nil or minified == "" then
-        error("result was nil or empty")
-        return
-    end
-
+    local minified = M.minify_string(content)
     local root = utils.get_treesitter_root()
     utils.replace_tsnode_text(root, minified)
 end
@@ -19,12 +20,7 @@ end
 ---@param input_json string
 ---@param target_node TSNode
 function M.minify_and_put(input_json, target_node)
-    local minified = jq.get_collapsed(input_json)
-    if minified == nil or minified == "" then
-        error("result was nil or empty")
-        return
-    end
-
+    local minified = M.minify_string(input_json)
     utils.replace_tsnode_text(target_node, minified)
 end
 
diff --git a/lua/json-nvim/utils.lua b/lua/json_nvim/utils.lua
similarity index 90%
rename from lua/json-nvim/utils.lua
rename to lua/json_nvim/utils.lua
index 62df204..39e8786 100644
--- a/lua/json-nvim/utils.lua
+++ b/lua/json_nvim/utils.lua
@@ -2,21 +2,19 @@ local M = {}
 
 -- some of the functions below
 -- are just in case
-
-function M.get_plugin_root()
-    local file_separator = ""
-    if vim.fn.has("win32") == 1 then
-        file_separator = "\\"
-    else
-        file_separator = "/"
-    end
-
+---@return string
+local function get_os_file_separator()
+    local file_separator
     local init_path = debug.getinfo(1).source
 
     if not init_path:find("\\") then
         file_separator = "/"
     end
+    return file_separator
+end
 
+function M.get_plugin_root()
+    local file_separator = get_os_file_separator()
     local target_index = 0
     local separator_encountered = 0
     for i = #init_path, 1, -1 do
@@ -39,6 +37,23 @@ function M.get_jq_modules_directory()
     return result
 end
 
+-- Returns the OS TMP DIR and path_separator
+---@return string?
+---@return string
+function M.get_os_temp_file_path()
+    local tmp_dir
+    if vim.fn.has("win32") == 1 then
+        tmp_dir = os.getenv("TEMP")
+    else
+        tmp_dir = os.getenv("TMPDIR")
+    end
+    if not tmp_dir then
+        error("json_nvim uses temp files. Either $TEMP (Windows) or $TMPDIR (Unix) must be defined")
+    end
+
+    return tmp_dir, get_os_file_separator()
+end
+
 ---takes json string as keys and returns which casing is used
 ---@param input string
 ---@return string
diff --git a/plugin/json-nvim.lua b/plugin/json-nvim.lua
index 5319711..b24577d 100644
--- a/plugin/json-nvim.lua
+++ b/plugin/json-nvim.lua
@@ -1,4 +1,4 @@
-local json_nvim = require("json-nvim")
+local json_nvim = require("json_nvim")
 
 local function command(name, callback, options)
     local final_opts = vim.tbl_deep_extend("force", options or {}, { bang = true })
@@ -21,11 +21,11 @@ command("JsonMinifySelection", function()
     json_nvim.MinifySelection()
 end, { range = true })
 
-command("JsonFormatToken", function()
+command("JsonFormatNode", function()
     json_nvim.FormatToken()
 end)
 
-command("JsonMinifyToken", function()
+command("JsonMinifyNode", function()
     json_nvim.MinifyToken()
 end)
 
diff --git a/tests/golden/escape_file.json.golden b/tests/golden/escape_file.json.golden
new file mode 100644
index 0000000..1e70db8
--- /dev/null
+++ b/tests/golden/escape_file.json.golden
@@ -0,0 +1 @@
+"[{\"_id\":\"67b3739c332882c1456e076b\",\"index\":0,\"guid\":\"9a249e2b-173b-4ab9-ac77-9257d780eedb\",\"isActive\":true,\"balance\":\"$3,456.75\",\"picture\":\"http://placehold.it/32x32\",\"age\":28,\"eyeColor\":\"green\",\"name\":\"Olga Hess\",\"gender\":\"female\",\"company\":\"REPETWIRE\",\"email\":\"olgahess@repetwire.com\",\"phone\":\"+1 (920) 506-2554\",\"address\":\"918 Fillmore Avenue, Chapin, Indiana, 8526\",\"about\":\"Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\\r\\n\",\"registered\":\"2016-07-23T05:21:41 -04:00\",\"latitude\":-38.870975,\"longitude\":139.528881,\"tags\":[\"nisi\",\"aliquip\",\"exercitation\",\"id\",\"velit\",\"eiusmod\",\"proident\"],\"friends\":[{\"id\":0,\"name\":\"Constance Mcmillan\"},{\"id\":1,\"name\":\"Alexandria Lamb\"},{\"id\":2,\"name\":\"Amparo Barber\"}],\"greeting\":\"Hello, Olga Hess! You have 8 unread messages.\",\"favoriteFruit\":\"strawberry\"}]"
diff --git a/tests/golden/format_file.json.golden b/tests/golden/format_file.json.golden
new file mode 100644
index 0000000..bd44563
--- /dev/null
+++ b/tests/golden/format_file.json.golden
@@ -0,0 +1,47 @@
+[
+  {
+    "_id": "67b3739c332882c1456e076b",
+    "index": 0,
+    "guid": "9a249e2b-173b-4ab9-ac77-9257d780eedb",
+    "isActive": true,
+    "balance": "$3,456.75",
+    "picture": "http://placehold.it/32x32",
+    "age": 28,
+    "eyeColor": "green",
+    "name": "Olga Hess",
+    "gender": "female",
+    "company": "REPETWIRE",
+    "email": "olgahess@repetwire.com",
+    "phone": "+1 (920) 506-2554",
+    "address": "918 Fillmore Avenue, Chapin, Indiana, 8526",
+    "about": "Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n",
+    "registered": "2016-07-23T05:21:41 -04:00",
+    "latitude": -38.870975,
+    "longitude": 139.528881,
+    "tags": [
+      "nisi",
+      "aliquip",
+      "exercitation",
+      "id",
+      "velit",
+      "eiusmod",
+      "proident"
+    ],
+    "friends": [
+      {
+        "id": 0,
+        "name": "Constance Mcmillan"
+      },
+      {
+        "id": 1,
+        "name": "Alexandria Lamb"
+      },
+      {
+        "id": 2,
+        "name": "Amparo Barber"
+      }
+    ],
+    "greeting": "Hello, Olga Hess! You have 8 unread messages.",
+    "favoriteFruit": "strawberry"
+  }
+]
diff --git a/tests/golden/minify_file.json.golden b/tests/golden/minify_file.json.golden
new file mode 100644
index 0000000..9e43f1d
--- /dev/null
+++ b/tests/golden/minify_file.json.golden
@@ -0,0 +1 @@
+[{"_id":"67b3739c332882c1456e076b","index":0,"guid":"9a249e2b-173b-4ab9-ac77-9257d780eedb","isActive":true,"balance":"$3,456.75","picture":"http://placehold.it/32x32","age":28,"eyeColor":"green","name":"Olga Hess","gender":"female","company":"REPETWIRE","email":"olgahess@repetwire.com","phone":"+1 (920) 506-2554","address":"918 Fillmore Avenue, Chapin, Indiana, 8526","about":"Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n","registered":"2016-07-23T05:21:41 -04:00","latitude":-38.870975,"longitude":139.528881,"tags":["nisi","aliquip","exercitation","id","velit","eiusmod","proident"],"friends":[{"id":0,"name":"Constance Mcmillan"},{"id":1,"name":"Alexandria Lamb"},{"id":2,"name":"Amparo Barber"}],"greeting":"Hello, Olga Hess! You have 8 unread messages.","favoriteFruit":"strawberry"}]
diff --git a/tests/golden/unescape_file.json.golden b/tests/golden/unescape_file.json.golden
new file mode 100644
index 0000000..9e43f1d
--- /dev/null
+++ b/tests/golden/unescape_file.json.golden
@@ -0,0 +1 @@
+[{"_id":"67b3739c332882c1456e076b","index":0,"guid":"9a249e2b-173b-4ab9-ac77-9257d780eedb","isActive":true,"balance":"$3,456.75","picture":"http://placehold.it/32x32","age":28,"eyeColor":"green","name":"Olga Hess","gender":"female","company":"REPETWIRE","email":"olgahess@repetwire.com","phone":"+1 (920) 506-2554","address":"918 Fillmore Avenue, Chapin, Indiana, 8526","about":"Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n","registered":"2016-07-23T05:21:41 -04:00","latitude":-38.870975,"longitude":139.528881,"tags":["nisi","aliquip","exercitation","id","velit","eiusmod","proident"],"friends":[{"id":0,"name":"Constance Mcmillan"},{"id":1,"name":"Alexandria Lamb"},{"id":2,"name":"Amparo Barber"}],"greeting":"Hello, Olga Hess! You have 8 unread messages.","favoriteFruit":"strawberry"}]
diff --git a/tests/inputs/escape_file.json b/tests/inputs/escape_file.json
new file mode 100644
index 0000000..bd44563
--- /dev/null
+++ b/tests/inputs/escape_file.json
@@ -0,0 +1,47 @@
+[
+  {
+    "_id": "67b3739c332882c1456e076b",
+    "index": 0,
+    "guid": "9a249e2b-173b-4ab9-ac77-9257d780eedb",
+    "isActive": true,
+    "balance": "$3,456.75",
+    "picture": "http://placehold.it/32x32",
+    "age": 28,
+    "eyeColor": "green",
+    "name": "Olga Hess",
+    "gender": "female",
+    "company": "REPETWIRE",
+    "email": "olgahess@repetwire.com",
+    "phone": "+1 (920) 506-2554",
+    "address": "918 Fillmore Avenue, Chapin, Indiana, 8526",
+    "about": "Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n",
+    "registered": "2016-07-23T05:21:41 -04:00",
+    "latitude": -38.870975,
+    "longitude": 139.528881,
+    "tags": [
+      "nisi",
+      "aliquip",
+      "exercitation",
+      "id",
+      "velit",
+      "eiusmod",
+      "proident"
+    ],
+    "friends": [
+      {
+        "id": 0,
+        "name": "Constance Mcmillan"
+      },
+      {
+        "id": 1,
+        "name": "Alexandria Lamb"
+      },
+      {
+        "id": 2,
+        "name": "Amparo Barber"
+      }
+    ],
+    "greeting": "Hello, Olga Hess! You have 8 unread messages.",
+    "favoriteFruit": "strawberry"
+  }
+]
diff --git a/tests/inputs/format_file.json b/tests/inputs/format_file.json
new file mode 100644
index 0000000..6de7c2a
--- /dev/null
+++ b/tests/inputs/format_file.json
@@ -0,0 +1,2 @@
+[{"_id":"67b3739c332882c1456e076b","index":0,"guid":"9a249e2b-173b-4ab9-ac77-9257d780eedb","isActive":true,"balance":"$3,456.75","picture":"http://placehold.it/32x32","age":28,"eyeColor":"green","name":"Olga Hess","gender":"female","company":"REPETWIRE","email":"olgahess@repetwire.com","phone":"+1 (920) 506-2554","address":"918 Fillmore Avenue, Chapin, Indiana, 8526","about":"Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n","registered":"2016-07-23T05:21:41 -04:00","latitude":-38.870975,"longitude":139.528881,"tags":["nisi","aliquip","exercitation","id","velit","eiusmod","proident"],"friends":[{"id":0,"name":"Constance Mcmillan"},{"id":1,"name":"Alexandria Lamb"},{"id":2,"name":"Amparo Barber"}],"greeting":"Hello, Olga Hess! You have 8 unread messages.","favoriteFruit":"strawberry"}]
+
diff --git a/tests/inputs/minify_file.json b/tests/inputs/minify_file.json
new file mode 100644
index 0000000..bd44563
--- /dev/null
+++ b/tests/inputs/minify_file.json
@@ -0,0 +1,47 @@
+[
+  {
+    "_id": "67b3739c332882c1456e076b",
+    "index": 0,
+    "guid": "9a249e2b-173b-4ab9-ac77-9257d780eedb",
+    "isActive": true,
+    "balance": "$3,456.75",
+    "picture": "http://placehold.it/32x32",
+    "age": 28,
+    "eyeColor": "green",
+    "name": "Olga Hess",
+    "gender": "female",
+    "company": "REPETWIRE",
+    "email": "olgahess@repetwire.com",
+    "phone": "+1 (920) 506-2554",
+    "address": "918 Fillmore Avenue, Chapin, Indiana, 8526",
+    "about": "Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\r\n",
+    "registered": "2016-07-23T05:21:41 -04:00",
+    "latitude": -38.870975,
+    "longitude": 139.528881,
+    "tags": [
+      "nisi",
+      "aliquip",
+      "exercitation",
+      "id",
+      "velit",
+      "eiusmod",
+      "proident"
+    ],
+    "friends": [
+      {
+        "id": 0,
+        "name": "Constance Mcmillan"
+      },
+      {
+        "id": 1,
+        "name": "Alexandria Lamb"
+      },
+      {
+        "id": 2,
+        "name": "Amparo Barber"
+      }
+    ],
+    "greeting": "Hello, Olga Hess! You have 8 unread messages.",
+    "favoriteFruit": "strawberry"
+  }
+]
diff --git a/tests/inputs/unescape_file.txt b/tests/inputs/unescape_file.txt
new file mode 100644
index 0000000..eacdd7e
--- /dev/null
+++ b/tests/inputs/unescape_file.txt
@@ -0,0 +1,2 @@
+"[{\"_id\":\"67b3739c332882c1456e076b\",\"index\":0,\"guid\":\"9a249e2b-173b-4ab9-ac77-9257d780eedb\",\"isActive\":true,\"balance\":\"$3,456.75\",\"picture\":\"http://placehold.it/32x32\",\"age\":28,\"eyeColor\":\"green\",\"name\":\"Olga Hess\",\"gender\":\"female\",\"company\":\"REPETWIRE\",\"email\":\"olgahess@repetwire.com\",\"phone\":\"+1 (920) 506-2554\",\"address\":\"918 Fillmore Avenue, Chapin, Indiana, 8526\",\"about\":\"Proident ea enim sit commodo ullamco minim sint non. Cupidatat reprehenderit pariatur sit in in pariatur reprehenderit consectetur occaecat sit. Consectetur excepteur nisi adipisicing pariatur ullamco labore voluptate elit in do.\\r\\n\",\"registered\":\"2016-07-23T05:21:41 -04:00\",\"latitude\":-38.870975,\"longitude\":139.528881,\"tags\":[\"nisi\",\"aliquip\",\"exercitation\",\"id\",\"velit\",\"eiusmod\",\"proident\"],\"friends\":[{\"id\":0,\"name\":\"Constance Mcmillan\"},{\"id\":1,\"name\":\"Alexandria Lamb\"},{\"id\":2,\"name\":\"Amparo Barber\"}],\"greeting\":\"Hello, Olga Hess! You have 8 unread messages.\",\"favoriteFruit\":\"strawberry\"}]"
+
diff --git a/tests/run_tests.lua b/tests/run_tests.lua
new file mode 100644
index 0000000..9c4bbcb
--- /dev/null
+++ b/tests/run_tests.lua
@@ -0,0 +1,83 @@
+-- Add the plugin source to the Lua package path
+package.path = package.path .. ";./lua/?.lua;./lua/?/init.lua"
+
+-- Require the module
+local json_nvim = require("json_nvim")
+local update_golden = arg[1] == "--update"
+-- Simple file helper functions
+local function read_file(path)
+    local f = assert(io.open(path, "r"))
+    local content = f:read("*a")
+    f:close()
+    return content
+end
+
+local function write_file(path, data)
+    local f = assert(io.open(path, "w"))
+    f:write(data)
+    f:close()
+end
+
+-- Run a single test
+local function run_test(name, input_file, golden_file, transform_fn)
+    local input = read_file(input_file)
+    local expected = read_file(golden_file)
+    local append_warning = "WARN: a newline was appended to output to match POSIX golden."
+    -- Use your plugin's transformation (e.g., minifier)
+    -- print(input)
+    local actual = transform_fn(input)
+    if not actual:match("\n$") then
+        actual = actual .. "\n"
+    end
+    if actual == expected then
+        print("✅ " .. name .. ": PASS")
+    else
+        if update_golden then
+            write_file(golden_file, actual)
+            print("🔁 " .. name .. ": Updated golden file.")
+            return
+        end
+        if expected ~= actual then
+            print("Mismatch:")
+            print("Expected: [" .. vim.inspect(expected) .. "]")
+            print("Actual:   [" .. vim.inspect(actual) .. "]")
+        end
+        print("❌ " .. name .. ": FAIL")
+        -- Optional: write diff to disk for inspection
+        write_file("tests/" .. name .. ".actual", actual)
+        write_file("tests/" .. name .. ".expected", expected)
+    end
+end
+
+-- Register your tests here
+local tests = {
+    {
+        name = "Minify File",
+        input = "tests/inputs/minify_file.json",
+        golden = "tests/golden/minify_file.json.golden",
+        fn = require("json_nvim.minifier").minify_string,
+    },
+    {
+        name = "Format File",
+        input = "tests/inputs/format_file.json",
+        golden = "tests/golden/format_file.json.golden",
+        fn = require("json_nvim.formatter").format_string,
+    },
+    {
+        name = "Escape File",
+        input = "tests/inputs/escape_file.json",
+        golden = "tests/golden/escape_file.json.golden",
+        fn = require("json_nvim.escaper").escape_string,
+    },
+    {
+        name = "Unescape File",
+        input = "tests/inputs/unescape_file.txt",
+        golden = "tests/golden/unescape_file.json.golden",
+        fn = require("json_nvim.escaper").unescape_string,
+    },
+}
+
+-- Run them all
+for _, test in ipairs(tests) do
+    run_test(test.name, test.input, test.golden, test.fn)
+end