diff --git a/README.md b/README.md
index 8384e81..eea3327 100644
--- a/README.md
+++ b/README.md
@@ -159,31 +159,48 @@ Consult the list below for available settings:
 ```lua
 local actions = require "fzf-lua.actions"
 require'fzf-lua'.setup {
-  win_height          = 0.85,         -- window height
-  win_width           = 0.80,         -- window width
-  win_row             = 0.30,         -- window row position (0=top, 1=bottom)
-  win_col             = 0.50,         -- window col position (0=left, 1=right)
-  -- win_border          = false,         -- window border? or borderchars?
-  win_border          = { '╭', '─', '╮', '│', '╯', '─', '╰', '│' },
-  -- fzf_bin             = 'sk',         -- use skim instead of fzf?
-  fzf_layout          = 'reverse',    -- fzf '--layout='
-  fzf_args            = '',           -- adv: fzf extra args, empty unless adv
-  preview_cmd         = '',           -- 'head -n $FZF_PREVIEW_LINES',
-  preview_border      = 'border',     -- border|noborder
-  preview_wrap        = 'nowrap',     -- wrap|nowrap
-  preview_opts        = 'nohidden',   -- hidden|nohidden
-  preview_vertical    = 'down:45%',   -- up|down:size
-  preview_horizontal  = 'right:60%',  -- right|left:size
-  preview_layout      = 'flex',       -- horizontal|vertical|flex
-  flip_columns        = 120,          -- #cols to switch to horizontal on flex
+  winopts = {
+    win_height       = 0.85,            -- window height
+    win_width        = 0.80,            -- window width
+    win_row          = 0.30,            -- window row position (0=top, 1=bottom)
+    win_col          = 0.50,            -- window col position (0=left, 1=right)
+    -- win_border    = false,           -- window border? or borderchars?
+    win_border       = { '╭', '─', '╮', '│', '╯', '─', '╰', '│' },
+    window_on_create = function()         -- nvim window options override
+      vim.cmd("set winhl=Normal:Normal")  -- popup bg match normal windows
+    end,
+  },
+  -- fzf_bin             = 'sk',        -- use skim instead of fzf?
+  fzf_layout          = 'reverse',      -- fzf '--layout='
+  fzf_args            = '',             -- adv: fzf extra args, empty unless adv
+  fzf_binds           = {               -- fzf '--bind=' options
+      'f2:toggle-preview',
+      'f3:toggle-preview-wrap',
+      'shift-down:preview-page-down',
+      'shift-up:preview-page-up',
+      'ctrl-d:half-page-down',
+      'ctrl-u:half-page-up',
+      'ctrl-f:page-down',
+      'ctrl-b:page-up',
+      'ctrl-a:toggle-all',
+      'ctrl-l:clear-query',
+  },
+  preview_cmd         = '',             -- 'head -n $FZF_PREVIEW_LINES',
+  preview_border      = 'border',       -- border|noborder
+  preview_wrap        = 'nowrap',       -- wrap|nowrap
+  preview_opts        = 'nohidden',     -- hidden|nohidden
+  preview_vertical    = 'down:45%',     -- up|down:size
+  preview_horizontal  = 'right:60%',    -- right|left:size
+  preview_layout      = 'flex',         -- horizontal|vertical|flex
+  flip_columns        = 120,            -- #cols to switch to horizontal on flex
   bat_theme           = 'Coldark-Dark', -- bat preview theme (bat --list-themes)
-  bat_opts            = '--style=numbers,changes --color always',
+  -- provider setup
   files = {
     prompt            = 'Files❯ ',
-    cmd               = '',           -- "find . -type f -printf '%P\n'",
-    git_icons         = true,         -- show git icons?
-    file_icons        = true,         -- show file icons?
-    color_icons       = true,         -- colorize file|git icons
+    cmd               = '',             -- "find . -type f -printf '%P\n'",
+    git_icons         = true,           -- show git icons?
+    file_icons        = true,           -- show file icons?
+    color_icons       = true,           -- colorize file|git icons
     actions = {
       ["default"]     = actions.file_edit,
       ["ctrl-s"]      = actions.file_split,
@@ -196,27 +213,28 @@ require'fzf-lua'.setup {
   git = {
     prompt            = 'GitFiles❯ ',
     cmd               = 'git ls-files --exclude-standard',
-    git_icons         = true,         -- show git icons?
-    file_icons        = true,         -- show file icons?
-    color_icons       = true,         -- colorize file|git icons
+    git_icons         = true,           -- show git icons?
+    file_icons        = true,           -- show file icons?
+    color_icons       = true,           -- colorize file|git icons
     icons = {
-        ["M"]     = { icon = "M", color = "yellow" },
-        ["D"]     = { icon = "D", color = "red" },
-        ["A"]     = { icon = "A", color = "green" },
-        ["?"]     = { icon = "?", color = "magenta" },
-        -- ["M"]     = { icon = "★", color = "red" },
-        -- ["D"]     = { icon = "✗", color = "red" },
-        -- ["A"]     = { icon = "+", color = "green" },
+      ["M"]           = { icon = "M", color = "yellow" },
+      ["D"]           = { icon = "D", color = "red" },
+      ["A"]           = { icon = "A", color = "green" },
+      ["?"]           = { icon = "?", color = "magenta" },
+      -- ["M"]          = { icon = "★", color = "red" },
+      -- ["D"]          = { icon = "✗", color = "red" },
+      -- ["A"]          = { icon = "+", color = "green" },
     },
   },
   grep = {
     prompt            = 'Rg❯ ',
     input_prompt      = 'Grep For❯ ',
     -- cmd               = "rg --vimgrep",
-    rg_opts           = "--hidden --column --line-number --no-heading --color=always --smart-case -g '!{.git,node_modules}/*'",
-    git_icons         = true,         -- show git icons?
-    file_icons        = true,         -- show file icons?
-    color_icons       = true,         -- colorize file|git icons
+    rg_opts           = "--hidden --column --line-number --no-heading " ..
+                        "--color=always --smart-case -g '!{.git,node_modules}/*'",
+    git_icons         = true,           -- show git icons?
+    file_icons        = true,           -- show file icons?
+    color_icons       = true,           -- colorize file|git icons
     actions = {
       ["default"]     = actions.file_edit,
       ["ctrl-s"]      = actions.file_split,
@@ -245,20 +263,22 @@ require'fzf-lua'.setup {
   },
   colorschemes = {
     prompt            = 'Colorschemes❯ ',
-    live_preview      = true,
+    live_preview      = true,       -- apply the colorscheme on preview?
     actions = {
       ["default"]     = actions.colorscheme,
       ["ctrl-y"]      = function(selected) print(selected[2]) end,
     },
     winopts = {
-      win_height       = 0.55,
-      win_width        = 0.30,
-      window_on_create = function()
+      win_height        = 0.55,
+      win_width         = 0.30,
+      window_on_create  = function()
         vim.cmd("set winhl=Normal:Normal")
       end,
     },
-    post_reset_cb    = function()
-      require('feline').reset_highlights()
+    post_reset_cb     = function()
+      -- reset statusline highlights after
+      -- a live_preview of the colorscheme
+      -- require('feline').reset_highlights()
     end,
   },
   quickfix = {
@@ -284,24 +304,13 @@ require'fzf-lua'.setup {
   loclist = {},
   helptags = {},
   manpages = {},
-  file_icon_colors = {                -- override colors for extensions
+  -- optional override of file extension icon colors
+  -- available colors (terminal):
+  --    clear, bold, black, red, green, yellow
+  --    blue, magenta, cyan, grey, dark_grey, white
+  file_icon_colors = {
     ["lua"]   = "blue",
   },
-  fzf_binds           = {             -- fzf '--bind=' options
-    'f2:toggle-preview',
-    'f3:toggle-preview-wrap',
-    'shift-down:preview-page-down',
-    'shift-up:preview-page-up',
-    'ctrl-d:half-page-down',
-    'ctrl-u:half-page-up',
-    'ctrl-f:page-down',
-    'ctrl-b:page-up',
-    'ctrl-a:toggle-all',
-    'ctrl-l:clear-query',
-  },
-  window_on_create = function()         -- nvim window options override
-    vim.cmd("set winhl=Normal:Normal")  -- popup bg match normal windows
-  end,
 }
 ```