ftconfig.nvim

A Neovim plugin for managing per-filetype configuration with ease. Configure indentation, formatters, and other filetype-specific settings in individual Lua files.

Features

• Per-filetype configuration: Create separate config files for each filetype
• Automatic indentation: Set custom indentation per filetype (shiftwidth, tabstop, softtabstop)
• Conform.nvim integration: Configure formatters per filetype
• Easy editing: Quick commands and Telescope integration for editing configs
• Auto-completion: Filetype completion for commands

Installation

lazy.nvim

{
  "huncholane/ftconfig.nvim",
  dependencies = {
    "telescope.nvim", -- optional, for telescope integration
    "conform.nvim",   -- optional, for formatter integration
  },
  config = function()
    require("ftconfig").setup()
  end,
}

packer.nvim

use {
  "huncholane/ftconfig.nvim",
  requires = {
    "nvim-telescope/telescope.nvim", -- optional
    "stevearc/conform.nvim",         -- optional
  },
  config = function()
    require("ftconfig").setup()
  end,
}

Usage

Commands

• :FT [filetype] - Edit or create config for the specified filetype
• :FT - Edit config for the current buffer's filetype

Telescope Extension

Load the telescope extension:

require("telescope").load_extension("ftconfig")

Then use:

• :Telescope ftconfig - Browse and select filetypes to configure

The picker shows:

• Current buffer's filetype (prioritized)
• Filetypes with existing configs
• Other available filetypes

Configuration

Filetype configs are stored in ~/.config/nvim/lua/ftconfig/ as individual .lua files.

Example Filetype Config

Create ~/.config/nvim/lua/ftconfig/javascript.lua:

---@type FTSpec
return {
  -- Set indentation to 2 spaces
  indent = 2,

  -- Configure formatters via conform.nvim
  conform = {
    use = { "prettier", "eslint_d" },
    formatters = {
      prettier = {
        prepend_args = { "--tab-width", "2" }
      }
    }
  },

  -- LSP configuration (placeholder for future features)
  lsp = {
    -- Reserved for future LSP integration
  }
}

Configuration Schema

---@class FTSpec
---@field indent? integer          -- Indentation size (default: 4)
---@field conform? FTConformSpec   -- Conform.nvim configuration
---@field lsp? table<LSPName, any> -- LSP configuration (reserved)

---@class FTConformSpec
---@field use string[]                                    -- List of formatters to use
---@field formatters? table<string, conform.FileFormatterConfig> -- Formatter-specific config

Examples

Python with Black formatting

~/.config/nvim/lua/ftconfig/python.lua:

return {
  indent = 4,
  conform = {
    use = { "black", "isort" },
    formatters = {
      black = {
        prepend_args = { "--line-length", "88" }
      }
    }
  }
}

Go with gofmt

~/.config/nvim/lua/ftconfig/go.lua:

return {
  indent = 4,
  conform = {
    use = { "gofmt", "goimports" }
  }
}

Lua with stylua

~/.config/nvim/lua/ftconfig/lua.lua:

return {
  indent = 2,
  conform = {
    use = { "stylua" },
    formatters = {
      stylua = {
        prepend_args = { "--indent-type", "Spaces", "--indent-width", "2" }
      }
    }
  }
}

How It Works

1. On setup, the plugin scans ~/.config/nvim/lua/ftconfig/ for .lua files
2. Each file is loaded as a filetype configuration
3. FileType autocmds are created to apply indentation settings
4. Conform.nvim is configured with the specified formatters
5. The :FT command and Telescope extension provide easy access to edit configs

Requirements

• Neovim >= 0.7.0
• Optional: conform.nvim for formatter integration
• Optional: telescope.nvim for the picker interface

License

MIT