Skip to content

Practicalli Nvim-Astro Configλ︎

Practicalli Logo Practicalli Logo

Practicalli Astro 5 is Clojure development focused configuration, an extension of the AstroNvim v5 template repository.

Clone the Practicalli Astro configuration or create your own fork and clone that repository.

Clone Practicalli Astro 5 config

git clone https://github.com/practicalli/nvim-astro.git ~/.config/nvim

Clone the Practicalli Astro configuration to a unique name within ~/.config directory.

Clone Practicalli Astro 5 config

git clone https://github.com/practicalli/astro.git ~/.config/nvim-astro

Set the NVIM_APPNAME environment variable to the configuration directory name under ~/.config, e.g. Run Neovim using the configuration in ~/.config/nvim-astro

Use Nvim-Astro config with Neovim

export NVIM_APPNAME=nvim-astro nvim

Configure shell alias and selectors to simplify the command to run a specific configuration.

Customise Practicalli Astro 5

Install Neovim Pluginsλ︎

Run Neovim in a terminal and all the plugins and supporting Mason tools from the Practicalli Nvim-Astro configuration will be installed. Treesitter parsers for all supported languages are installed too.

Run Neovim

With a single Neovim Config, use the nvim command in a terminal

nvim

With multiple configurations, use a shell alias or set the NVIM_APPNAME to set the preferred configuration. For example, with Nvim-Astro, use the astro alias.

nvim

Lazy plugin manager runs automatically and installs all the plugins defined in the Neovim configuration.

Mason runs and installs tools that are defined in the configuration.

Treesitter will compile all the language parsers.

q to close the lazy package manager pop-up once all plugins are installed.

Breaking Changes - update packages again

If a "Breaking Changes" section is shown when adding or updating plugins in the Lazy popup, press U key to update again until no more breaking changes show.

Avoid running Nvim-Astro package update headless

Do not use the --headless Neovim flag to install plugins or pass the +:Lazy update arguments. The Lazy.nvim package manager requires neovim UI to run correctly.

Identical install with lazy-lock.json

When plugins are installed, a lazy-lock.json contains the versions of all plugins. Include this file when exact plugin versions are required for other system installs. Otherwise this file can be safely ignored.

Post Install checksλ︎

Troubleshoot the Neovim configuration and supporting tools by running the 🌐 Neovim Heath Check.

Use the :checkhealth command in Neovim or start Neovim with the Health Check command.

Run Neovim and start Health Check

nvim +:checkhealth

A report is generated and shown in Neovim

j / j to scroll through the checkhealth report

Review the warnings and install tooling that is required for languages that will be used.

NeoVim checkhealth report NeoVim checkhealth report

Ignore Provider Warnings

It is safe to ignore language provider warnings.

Language Providers can be disabled in the Neovim configuration to remove the warnings from :checkhealth report.

Troubleshoot Neovim Configuration