diff --git a/README.md b/README.md
index 39d8811..87dc288 100644
--- a/README.md
+++ b/README.md
@@ -38,19 +38,12 @@ Via [lazy.nvim](https://github.com/folke/lazy.nvim):
 ### Configuration
 
 ```lua
-require('lazy').setup({
-  -- HTTP REST-Client Interface
-  {
-    'mistweaverco/kulala.nvim',
-    config = function()
-      -- Setup is required, even if you don't pass any options
-      require('kulala').setup()
-    end
-  },
-})
+{ 'mistweaverco/kulala.nvim', opts = {} },
 ```
+> [!NOTE]
+> `opts` needs to be at least an empty table `{}` and can't be completely omitted.
 
-See [setup options](https://kulala.mwco.app/docs/getting-started/setup-options) for more information.
+See [configuration options](https://kulala.mwco.app/docs/getting-started/configuration-options) for more information.
 
 ## Honorable mentions
 
diff --git a/docs/docs/getting-started/setup-options.md b/docs/docs/getting-started/configuration-options.md
similarity index 58%
rename from docs/docs/getting-started/setup-options.md
rename to docs/docs/getting-started/configuration-options.md
index e5c2222..b4bb4ce 100644
--- a/docs/docs/getting-started/setup-options.md
+++ b/docs/docs/getting-started/configuration-options.md
@@ -1,76 +1,79 @@
-# Setup Options
+# Configuration Options
 
-The following options can be set in the setup function.
+Kulala can be configured with the following options.
 
 ### Full example
 
-Here is a full example of setting up the Kulala plugin with the `setup` function:
-
-```lua title="setup.lua"
-require("kulala").setup({
-  -- split direction
-  -- possible values: "vertical", "horizontal"
-  split_direction = "vertical",
-  -- default_view, body or headers or headers_body
-  default_view = "body",
-  -- dev, test, prod, can be anything
-  -- see: https://learn.microsoft.com/en-us/aspnet/core/test/http-files?view=aspnetcore-8.0#environment-files
-  default_env = "dev",
-  -- enable/disable debug mode
-  debug = false,
-  -- default formatters/pathresolver for different content types
-  contenttypes = {
-    ["application/json"] = {
-      ft = "json",
-      formatter = { "jq", "." },
-      pathresolver = require("kulala.parser.jsonpath").parse,
+Here is a full example of setting up the Kulala plugin with the available `opts`:
+
+```lua title="kulala.lua"
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    -- split direction
+    -- possible values: "vertical", "horizontal"
+    split_direction = "vertical",
+    -- default_view, body or headers or headers_body
+    default_view = "body",
+    -- dev, test, prod, can be anything
+    -- see: https://learn.microsoft.com/en-us/aspnet/core/test/http-files?view=aspnetcore-8.0#environment-files
+    default_env = "dev",
+    -- enable/disable debug mode
+    debug = false,
+    -- default formatters/pathresolver for different content types
+    contenttypes = {
+      ["application/json"] = {
+        ft = "json",
+        formatter = { "jq", "." },
+        pathresolver = require("kulala.parser.jsonpath").parse,
+      },
+      ["application/xml"] = {
+        ft = "xml",
+        formatter = { "xmllint", "--format", "-" },
+        pathresolver = { "xmllint", "--xpath", "{{path}}", "-" },
+      },
+      ["text/html"] = {
+        ft = "html",
+        formatter = { "xmllint", "--format", "--html", "-" },
+        pathresolver = {},
+      },
     },
-    ["application/xml"] = {
-      ft = "xml",
-      formatter = { "xmllint", "--format", "-" },
-      pathresolver = { "xmllint", "--xpath", "{{path}}", "-" },
+    -- can be used to show loading, done and error icons in inlay hints
+    -- possible values: "on_request", "above_request", "below_request", or nil to disable
+    -- If "above_request" or "below_request" is used, the icons will be shown above or below the request line
+    -- Make sure to have a line above or below the request line to show the icons
+    show_icons = "on_request",
+    -- default icons
+    icons = {
+      inlay = {
+        loading = "⏳",
+        done = "✅",
+        error = "❌",
+      },
+      lualine = "🐼",
     },
-    ["text/html"] = {
-      ft = "html",
-      formatter = { "xmllint", "--format", "--html", "-" },
-      pathresolver = {},
+    -- additional cURL options
+    -- see: https://curl.se/docs/manpage.html
+    additional_curl_options = {},
+    -- scratchpad default contents
+    scratchpad_default_contents = {
+      "@MY_TOKEN_NAME=my_token_value",
+      "",
+      "# @name scratchpad",
+      "POST https://httpbin.org/post HTTP/1.1",
+      "accept: application/json",
+      "content-type: application/json",
+      "",
+      "{",
+      '  "foo": "bar"',
+      "}",
     },
+    -- enable winbar
+    winbar = false,
+    -- enable reading vscode rest client environment variables
+    vscode_rest_client_environmentvars = false,
   },
-  -- can be used to show loading, done and error icons in inlay hints
-  -- possible values: "on_request", "above_request", "below_request", or nil to disable
-  -- If "above_request" or "below_request" is used, the icons will be shown above or below the request line
-  -- Make sure to have a line above or below the request line to show the icons
-  show_icons = "on_request",
-  -- default icons
-  icons = {
-    inlay = {
-      loading = "⏳",
-      done = "✅",
-      error = "❌",
-    },
-    lualine = "🐼",
-  },
-  -- additional cURL options
-  -- see: https://curl.se/docs/manpage.html
-  additional_curl_options = {},
-  -- scratchpad default contents
-  scratchpad_default_contents = {
-    "@MY_TOKEN_NAME=my_token_value",
-    "",
-    "# @name scratchpad",
-    "POST https://httpbin.org/post HTTP/1.1",
-    "accept: application/json",
-    "content-type: application/json",
-    "",
-    "{",
-    '  "foo": "bar"',
-    "}",
-  },
-  -- enable winbar
-  winbar = false,
-  -- enable reading vscode rest client environment variables
-  vscode_rest_client_environmentvars = false,
-})
+}
 ```
 
 ### split_direction
@@ -87,9 +90,12 @@ Default: `vertical`
 Example:
 
 ```lua
-require("kulala").setup({
-  split_direction = "horizontal",
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    split_direction = "vertical",
+  },
+}
 ```
 
 ### default_view
@@ -107,9 +113,12 @@ Default: `body`
 Example:
 
 ```lua
-require("kulala").setup({
-  default_view = "body",
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    default_view = "body",
+  },
+}
 ```
 
 ### default_env
@@ -127,9 +136,12 @@ Default: `dev`
 Example:
 
 ```lua
-require("kulala").setup({
-  default_env = "body",
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    default_env = "dev",
+  },
+}
 ```
 
 ### debug
@@ -146,9 +158,12 @@ Default: `false`
 Example:
 
 ```lua
-require("kulala").setup({
-  debug = false,
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    debug = false,
+  },
+}
 ```
 
 ### contenttypes
@@ -203,13 +218,16 @@ contenttypes = {
 Example:
 
 ```lua
-require("kulala").setup({
-  contenttypes = {
-    ["text/xml"] = {
-      ft = "xml",
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    contenttypes = {
+      ["text/xml"] = {
+        ft = "xml",
+      },
     },
   },
-})
+}
 ```
 
 #### contenttypes.formatter
@@ -241,15 +259,18 @@ contenttypes = {
 Example:
 
 ```lua
-require("kulala").setup({
-  contenttypes = {
-    ["text/plain"] = {
-      formatter = function(body)
-        return body:lower()
-      end,
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    contenttypes = {
+      ["text/plain"] = {
+        formatter = function(body)
+          return body:lower()
+        end,
+      },
     },
   },
-})
+}
 ```
 
 #### contenttypes.pathresolver
@@ -286,13 +307,16 @@ contenttypes = {
 Example:
 
 ```lua
-require("kulala").setup({
-  contenttypes = {
-    ["text/xml"] = {
-      pathresolver = { "xmllint", "--xpath", "{{path}}", "-" },
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    contenttypes = {
+      ["text/xml"] = {
+        pathresolver = { "xmllint", "--xpath", "{{path}}", "-" },
+      },
     },
   },
-})
+}
 ```
 
 ### show_icons
@@ -337,16 +361,19 @@ icons = {
 Example:
 
 ```lua
-require("kulala").setup({
-  icons = {
-    inlay = {
-      loading = "⏳",
-      done = "✅"
-      error = "❌",
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    icons = {
+      inlay = {
+        loading = "⏳",
+        done = "✅"
+        error = "❌",
+      },
+      lualine = "🐼",
     },
-    lualine = "🐼",
   },
-})
+}
 ```
 
 ### additional_curl_options
@@ -362,9 +389,12 @@ Default: `{}`
 Example:
 
 ```lua
-require("kulala").setup({
-  additional_curl_options = { "--insecure", "-A", "Mozilla/5.0" },
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    additional_curl_options = { "--insecure", "-A", "Mozilla/5.0" },
+  },
+}
 ```
 
 ### scratchpad_default_contents
@@ -398,20 +428,23 @@ scratchpad_default_contents = {
 Example:
 
 ```lua
-require("kulala").setup({
-  scratchpad_default_contents = {
-    "@AUTH_USERNAME=my_username",
-    "",
-    "# @name scratchpad_special_name",
-    "POST https://httpbin.org/post HTTP/1.1",
-    "accept: application/json",
-    "content-type: application/json",
-    "",
-    "{",
-    '  "baz": "qux"',
-    "}",
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    scratchpad_default_contents = {
+      "@AUTH_USERNAME=my_username",
+      "",
+      "# @name scratchpad_special_name",
+      "POST https://httpbin.org/post HTTP/1.1",
+      "accept: application/json",
+      "content-type: application/json",
+      "",
+      "{",
+      '  "baz": "qux"',
+      "}",
+    },
   },
-})
+}
 ```
 
 ### winbar
@@ -428,9 +461,12 @@ Default: `false`
 Example:
 
 ```lua
-require("kulala").setup({
-  winbar = false,
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    winbar = false,
+  },
+}
 ```
 
 ### vscode_rest_client_environmentvars
@@ -449,8 +485,11 @@ Default: `false`
 Example:
 
 ```lua
-require("kulala").setup({
-  vscode_rest_client_environmentvars = true,
-})
+{
+  "mistweaverco/kulala.nvim",
+  opts = {
+    vscode_rest_client_environmentvars = true,
+  },
+}
 ```
 
diff --git a/docs/docs/getting-started/install.md b/docs/docs/getting-started/install.md
index 10da8d3..fbb7189 100644
--- a/docs/docs/getting-started/install.md
+++ b/docs/docs/getting-started/install.md
@@ -17,10 +17,13 @@ require('lazy').setup({
   -- HTTP REST-Client Interface
   {
     'mistweaverco/kulala.nvim',
-    config = function()
-      require('kulala').setup()
-    end
+    opts = {}
   },
 })
 ```
 
+:::warning
+
+`opts` needs to be at least an empty table `{}` and can't be completely omitted.
+
+:::
diff --git a/docs/docs/usage/dotenv-and-http-client.env.json-support.md b/docs/docs/usage/dotenv-and-http-client.env.json-support.md
index c6a0f4e..1d0b8db 100644
--- a/docs/docs/usage/dotenv-and-http-client.env.json-support.md
+++ b/docs/docs/usage/dotenv-and-http-client.env.json-support.md
@@ -57,7 +57,7 @@ You can freely define your own environment names.
 
 By default the `dev` environment is used.
 
-This can be overridden by [setting the `default_env` setup option](../getting-started/setup-options).
+This can be overridden by [setting the `default_env` configuration option](../getting-started/configuration-options).
 
 To change the environment, you can use the `:lua require('kulala').set_selected_env('prod')` command.
 
diff --git a/docs/docs/usage/public-methods.md b/docs/docs/usage/public-methods.md
index c949d50..a0d9db3 100644
--- a/docs/docs/usage/public-methods.md
+++ b/docs/docs/usage/public-methods.md
@@ -19,7 +19,7 @@ The scratchpad is a (throwaway) buffer where you can write your requests.
 It is useful for quick testing. It is useful for requests that you don't want to save.
 
 It's default contents can be configured via the
-[`scratchpad_default_contents`][scratchpad_default_contents] setup option.
+[`scratchpad_default_contents`][scratchpad_default_contents] configuration option.
 
 ### copy
 
@@ -88,5 +88,5 @@ See: https://learn.microsoft.com/en-us/aspnet/core/test/http-files?view=aspnetco
 If you omit the `env_key`,
 it will try to load up a telescope prompt to select an environment or fallback to using `vim.ui.select`.
 
-[scratchpad_default_contents]: ../getting-started/setup-options#scratchpad_default_contents
+[scratchpad_default_contents]: ../getting-started/configuration-options#scratchpad_default_contents
 [kulala-cmp-graphql]: https://github.com/mistweaverco/kulala-cmp-graphql.nvim
diff --git a/docs/sidebars.ts b/docs/sidebars.ts
index 7609a3a..6d96ee5 100644
--- a/docs/sidebars.ts
+++ b/docs/sidebars.ts
@@ -14,7 +14,7 @@ const sidebars: SidebarsConfig = {
       items: [
         'getting-started/install',
         'getting-started/requirements',
-        'getting-started/setup-options',
+        'getting-started/configuration-options',
       ],
     },
     {