diff --git a/lua/config/lazy.lua b/lua/config/lazy.lua
index aec5f07..5f89595 100644
--- a/lua/config/lazy.lua
+++ b/lua/config/lazy.lua
@@ -14,6 +14,7 @@ if not lazy_loaded then
   vim.cmd.quit()
 end
 
+---@type LazyConfig
 lazy.setup {
   spec = {
     -- TODO: change `branch="v4"` to `version="^4"` on release
diff --git a/lua/plugins/colorscheme.lua b/lua/plugins/colorscheme.lua
index a1a9895..e21c48a 100644
--- a/lua/plugins/colorscheme.lua
+++ b/lua/plugins/colorscheme.lua
@@ -1,5 +1,6 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
+---@type LazySpec
 return {
   "AstroNvim/astroui",
   ---@type AstroUIOpts
diff --git a/lua/plugins/community.lua b/lua/plugins/community.lua
index 8246db5..4181fbf 100644
--- a/lua/plugins/community.lua
+++ b/lua/plugins/community.lua
@@ -1,3 +1,4 @@
+---@type LazySpec
 return {
   -- Add community imports to the `lua/config/lazy.lua` file in your Neovim configuration folder (typically ~/.config/nvim)
   -- this guarantees that the community plugin specs are loaded before the user configuration
diff --git a/lua/plugins/core.lua b/lua/plugins/core.lua
index 4bcd022..680401a 100644
--- a/lua/plugins/core.lua
+++ b/lua/plugins/core.lua
@@ -1,4 +1,5 @@
 -- You can simply override any internal plugins using Lazy, here are some example operations:
+---@type LazySpec
 return {
   -- customize alpha options
   -- {
diff --git a/lua/plugins/highlights.lua b/lua/plugins/highlights.lua
index 9d3f10f..aaab8dd 100644
--- a/lua/plugins/highlights.lua
+++ b/lua/plugins/highlights.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- AstroUI allows you to easily modify highlight groups easily for any and all colorschemes
+---@type LazySpec
 return {
   "AstroNvim/astroui",
   ---@type AstroUIOpts
diff --git a/lua/plugins/init.lua b/lua/plugins/init.lua
index f284cce..7c6f032 100644
--- a/lua/plugins/init.lua
+++ b/lua/plugins/init.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- AstroCore allows you easy access to customize the default options provided in AstroNvim
+---@type LazySpec
 return {
   "AstroNvim/astrocore",
   ---@type AstroCoreOpts
diff --git a/lua/plugins/lsp.lua b/lua/plugins/lsp.lua
index 19eb035..15fdc57 100644
--- a/lua/plugins/lsp.lua
+++ b/lua/plugins/lsp.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- AstroLSP allows you to customize the features in AstroNvim's LSP configuration engine
+---@type LazySpec
 return {
   "AstroNvim/astrolsp",
   ---@type AstroLSPOpts
diff --git a/lua/plugins/mappings.lua b/lua/plugins/mappings.lua
index 1fdab9d..1753536 100644
--- a/lua/plugins/mappings.lua
+++ b/lua/plugins/mappings.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- AstroCore provides a central place to modify mappings set up as well as which-key menu titles
+---@type LazySpec
 return {
   "AstroNvim/astrocore",
   ---@type AstroCoreOpts
diff --git a/lua/plugins/mason.lua b/lua/plugins/mason.lua
index 695cc8c..74704ff 100644
--- a/lua/plugins/mason.lua
+++ b/lua/plugins/mason.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- Example customization of mason plugins
+---@type LazySpec
 return {
   -- use mason-lspconfig to configure LSP installations
   {
diff --git a/lua/plugins/none-ls.lua b/lua/plugins/none-ls.lua
index 8f8aa54..d4f2f4b 100644
--- a/lua/plugins/none-ls.lua
+++ b/lua/plugins/none-ls.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- Example customization of Null-LS sources
+---@type LazySpec
 return {
   "nvimtools/none-ls.nvim",
   opts = function(_, config)
diff --git a/lua/plugins/treesitter.lua b/lua/plugins/treesitter.lua
index f1c579c..f93f5c7 100644
--- a/lua/plugins/treesitter.lua
+++ b/lua/plugins/treesitter.lua
@@ -1,6 +1,7 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
 -- Example customization of Treesitter
+---@type LazySpec
 return {
   "nvim-treesitter/nvim-treesitter",
   opts = function(_, opts)
diff --git a/lua/plugins/ui.lua b/lua/plugins/ui.lua
index ac57a98..1e7d7a2 100644
--- a/lua/plugins/ui.lua
+++ b/lua/plugins/ui.lua
@@ -1,5 +1,6 @@
 if true then return {} end -- REMOVE THIS LINE TO ACTIVATE THIS FILE
 
+---@type LazySpec
 return {
   "AstroNvim/astroui",
   ---@type AstroUIOpts
diff --git a/lua/plugins/user.lua b/lua/plugins/user.lua
index a86a5ff..5c739f8 100644
--- a/lua/plugins/user.lua
+++ b/lua/plugins/user.lua
@@ -1,4 +1,5 @@
 -- You can also add new plugins here as well using the lazy syntax:
+---@type LazySpec
 return {
   -- "andweeb/presence.nvim",
   -- {