Project

info

You can enable the extra with the :LazyExtras command. Plugins marked as optional will only be configured if they are installed.

Below you can find a list of included plugins and their default settings.

caution

You don't need to copy the default settings to your config. They are only shown here for reference.

project.nvim

Options

opts = {
  manual_mode = true,
}

Full Spec

{
  "ahmedkhalf/project.nvim",
  opts = {
    manual_mode = true,
  },
  event = "VeryLazy",
  config = function(_, opts)
    require("project_nvim").setup(opts)
    local history = require("project_nvim.utils.history")
    history.delete_project = function(project)
      for k, v in pairs(history.recent_projects) do
        if v == project.value then
          history.recent_projects[k] = nil
          return
        end
      end
    end
    LazyVim.on_load("telescope.nvim", function()
      require("telescope").load_extension("projects")
    end)
  end,
}

telescope.nvim (optional)

Options

opts = nil

Full Spec

{
  "nvim-telescope/telescope.nvim",
  optional = true,
  keys = {
    { "<leader>fp", pick, desc = "Projects" },
  },
}

fzf-lua (optional)

Options

opts = nil

Full Spec

{
  "ibhagwan/fzf-lua",
  optional = true,
  keys = {
    { "<leader>fp", pick, desc = "Projects" },
  },
}

alpha-nvim (optional)

Options

opts = function(_, dashboard)
  local button = dashboard.button("p", " " .. " Projects", pick)
  button.opts.hl = "AlphaButtons"
  button.opts.hl_shortcut = "AlphaShortcut"
  table.insert(dashboard.section.buttons.val, 4, button)
end

Full Spec

{
  "goolord/alpha-nvim",
  optional = true,
  opts = function(_, dashboard)
    local button = dashboard.button("p", " " .. " Projects", pick)
    button.opts.hl = "AlphaButtons"
    button.opts.hl_shortcut = "AlphaShortcut"
    table.insert(dashboard.section.buttons.val, 4, button)
  end,
}

mini.starter (optional)

Options

opts = function(_, opts)
  local items = {
    {
      name = "Projects",
      action = pick,
      section = string.rep(" ", 22) .. "Telescope",
    },
  }
  vim.list_extend(opts.items, items)
end

Full Spec

{
  "echasnovski/mini.starter",
  optional = true,
  opts = function(_, opts)
    local items = {
      {
        name = "Projects",
        action = pick,
        section = string.rep(" ", 22) .. "Telescope",
      },
    }
    vim.list_extend(opts.items, items)
  end,
}

dashboard-nvim (optional)

Options

opts = function(_, opts)
  if not vim.tbl_get(opts, "config", "center") then
    return
  end
  local projects = {
    action = pick,
    desc = " Projects",
    icon = " ",
    key = "p",
  }

  projects.desc = projects.desc .. string.rep(" ", 43 - #projects.desc)
  projects.key_format = "  %s"

  table.insert(opts.config.center, 3, projects)
end

Full Spec

{
  "nvimdev/dashboard-nvim",
  optional = true,
  opts = function(_, opts)
    if not vim.tbl_get(opts, "config", "center") then
      return
    end
    local projects = {
      action = pick,
      desc = " Projects",
      icon = " ",
      key = "p",
    }

    projects.desc = projects.desc .. string.rep(" ", 43 - #projects.desc)
    projects.key_format = "  %s"

    table.insert(opts.config.center, 3, projects)
  end,
}

snacks.nvim (optional)

Options

opts = function(_, opts)
  table.insert(opts.dashboard.preset.keys, 3, {
    action = pick,
    desc = "Projects",
    icon = " ",
    key = "p",
  })
end

Full Spec

{
  "folke/snacks.nvim",
  optional = true,
  opts = function(_, opts)
    table.insert(opts.dashboard.preset.keys, 3, {
      action = pick,
      desc = "Projects",
      icon = " ",
      key = "p",
    })
  end,
}