require('dep') {
  -- dep manages dep ----------------------------------------------------------
  { 'squibid/dep',
    url = 'https://git.squi.bid/dep',
    pin = true,
    -- branch = 'dev'
  },

  -- colorschemes -------------------------------------------------------------
  { 'kvrohit/mellow.nvim',
    requires = 'nvim-treesitter/nvim-treesitter'
  },

  -- ui -----------------------------------------------------------------------
  { 'lukas-reineke/indent-blankline.nvim' }, -- indentation indicators
  { 'folke/which-key.nvim' }, -- key map help
  { 'rcarriga/nvim-notify' }, -- notifications
  { 'tjdevries/express_line.nvim', -- status bar
    requires = 'nvim-lua/plenary.nvim'
  },
  { 'goolord/alpha-nvim' }, -- start page
  { 'dinhhuy258/sfm.nvim', -- tree view
    deps = 'dinhhuy258/sfm-git.nvim'
  },
  { 'matbme/JABS.nvim' }, -- buffer switcher
  { 'stevearc/dressing.nvim', -- nice ui selectors
    requires = 'nvim-telescope/telescope.nvim'
  },
  { 'lukas-reineke/headlines.nvim',
    requires = 'nvim-neorg/neorg'
  },

  -- functional plugins -------------------------------------------------------
  { 'lewis6991/gitsigns.nvim' }, -- very helpful git things
  { 'squibid/git-yodel', -- git cache diff preview when in commit buffer
    url = 'https://git.squi.bid/git-yodel',
  },
  { 'chentoast/marks.nvim' }, -- marks in gutter
  { 'vidocqh/auto-indent.nvim' }, -- better tabbing into indents
  { 'mbbill/undotree' }, -- careful this one is written in vimscript
  { 'dhruvasagar/vim-table-mode' }, -- same with this one
  { 'windwp/nvim-autopairs' },
  { 'numToStr/Comment.nvim' },
  { 'ahmedkhalf/project.nvim' }, -- cd into root of project
  { 'akinsho/toggleterm.nvim' }, -- TODO: switch to tmux based popup terminal
  { 'mrjones2014/smart-splits.nvim'}, -- buffer resizing

  -- note taking --------------------------------------------------------------
  { 'nvim-neorg/neorg',
    config = function()
      if package.loaded['nvim-treesitter'] then
        vim.cmd(':Neorg sync-parsers<CR>')
      end
    end,
    requires = {
      'nvim-lua/plenary.nvim',
      'nvim-treesitter/nvim-treesitter',
      'folke/zen-mode.nvim'
    },
    deps = { 'nvim-neorg/neorg-telescope',
      requires = 'nvim-telescope/telescope.nvim'
    }
  },

  { 'jbyuki/venn.nvim' },

  -- fzf ----------------------------------------------------------------------
  { 'nvim-telescope/telescope.nvim',
    requires = 'nvim-lua/plenary.nvim',
    deps = {
      'nvim-telescope/telescope-file-browser.nvim',
      'nvim-telescope/telescope-symbols.nvim',
      'axieax/urlview.nvim'
    }
  },
  { 'nvim-telescope/telescope-fzf-native.nvim',
    config = function()
      vim.cmd('make')
    end,
    requires = 'nvim-telescope/telescope.nvim'
  },

  -- treesitter + colorizing --------------------------------------------------
  { 'nvim-treesitter/nvim-treesitter',
    deps = {
      'm-demare/hlargs.nvim',
      'Wansmer/treesj',
      'nvim-treesitter/nvim-treesitter-context'
    }
  },
  { 'NvChad/nvim-colorizer.lua' },
  { 'folke/todo-comments.nvim',
    requires = 'nvim-lua/plenary.nvim'
  },

  -- cmp ----------------------------------------------------------------------
  { 'hrsh7th/nvim-cmp',
    deps = {
      'lukas-reineke/cmp-under-comparator', -- better results
      'hrsh7th/cmp-buffer', -- buffers
      'FelipeLema/cmp-async-path', -- path
      'hrsh7th/cmp-calc', -- calculator
      'hrsh7th/cmp-nvim-lsp', -- lsp
      'uga-rosa/cmp-dictionary', -- dictionary
      'hrsh7th/cmp-nvim-lua', -- nvim lua api
      { 'doxnit/cmp-luasnip-choice', -- luasnip
        requires = 'L3MON4D3/LuaSnip'
      }
    },
  },

  -- snippets -----------------------------------------------------------------
  { 'L3MON4D3/LuaSnip',
    deps = 'rafamadriz/friendly-snippets'
  },

  -- lsp ----------------------------------------------------------------------
  { 'neovim/nvim-lspconfig' }, -- setup lsp
  { 'j-hui/fidget.nvim', -- shows lsp progress
    branch = 'legacy'
  },

  { 'ray-x/lsp_signature.nvim' }, -- see information about the current function
  { 'dnlhc/glance.nvim' }, -- diagnostic info at a glance
  { 'aznhe21/actions-preview.nvim', -- codeactions
    requires = 'nvim-telescope/telescope.nvim'
  },

  { 'danymat/neogen', -- generate lsp annotations
    requires = 'nvim-treesitter/nvim-treesitter'
  },

  { 'whynothugo/lsp_lines.nvim',
    url = 'https://git.sr.ht/~whynothugo/lsp_lines.nvim'
  },

  -- mason --------------------------------------------------------------------
  { 'williamboman/mason.nvim',
    deps = {
      'WhoIsSethDaniel/mason-tool-installer.nvim',
      'williamboman/mason-lspconfig.nvim'
    }
  }
}