Skip to content

Latest commit

 

History

History
81 lines (47 loc) · 3.53 KB

README.md

File metadata and controls

81 lines (47 loc) · 3.53 KB

Practicalli Astro Configuration

Clojure development and more with Neovim 0.10.x and AstroNvim version 4

Practicalli Neovim describes the Clojure REPL workflow, rich Git and GitHub clients and easy management of plugins and tools using this configuration.

🛠️ Installation

Clone the Practicalli Astro repository (create a fork if customisation desired)

git clone [email protected]:practicalli/astro $HOME/.config/nvim

Run nvim command and wait for all plugins to update

nvim

Multiple Neovim configs

Clone to $HOME/.config/astronvim if there is an existing neovim configuration and use the NVIM_APPNAME=astronvim nvim command to start Neovim with AstroNvim configuration

git clone [email protected]:practicalli/astro $HOME/.config/nvim-astro

Create a shell alias to run the new configuration, e.g. in .bashrc or .zshrc (or a shell-aliases file that each shell rc file sources)

alias astro="NVIM_APPNAME=nvim-astro nvim"

Load the alias into the current shell (or open a new shell)

source shell-aliases

Run astro and allow neovim packages to be installed and Treesitter language parsers to compile.

astro

Configuration

The configuration is based on the AstroNvim template config. Changes to existing file have been kept to a minimum, except for lua/community.lua which has additional plugins from the AstroNvim Community repository.

lua/plugins/example-config.lua shows how to modify and extend the AstroNvim configuration. This config is not loaded by defult.

Create your own lua/plugins/user-name.lua file to:

  • override default plugin configuration
  • add new plugins (or create a new file for a plugin to make them easier to be optional) or by customising the lua/plugins/user.lua file.

lua/plugins/user-practicalli.lua is an example of a user configuration that adds plugins and overrides plugin options.

Lua files in the lua/plugins directory are loaded in alphabetical order so plugin overrides should be the last file to load, e.g lua/plugins/user-*

Clojure LSP

Mason is used to install LSP servers, format & lint tools. Mason Registry maintains a list of the latest release for each tool (automatically updated).

Practicalli Astro can be configured to use a locally installed Clojure LSP server (using the instructions for your operating system). A commented configuration example is included in lua/plugins/user-practicalli.lua.

Sponsor Practicalli

Sponsor Practicalli via GitHub

All sponsorship funds are used to support the continued development of Practicalli series of books and videos, although most work is done at personal cost and time.

Thanks to Cognitect, Nubank and a wide range of other sponsors for your continued support