Getting Started

Welcome to timvim — a fully declarative, Nix-built Neovim configuration powered by the NVF framework. This section walks you from a bare machine to a running editor, and explains what you will see the first time it opens.

Everything is reproducible: the same flake produces the same editor on Linux, macOS and WSL2, with language servers, formatters, AI assistance and a Kartoza-branded interface already wired together.

New to Nix?

You only need Nix with flakes enabled. There is nothing to compile by hand and no plugin manager to babysit — the flake does it all.

In this section

• Installation — Install Nix, enable flakes and run timvim in one command. Get started

• Home Manager — Add timvim to your Home Manager or NixOS configuration for a permanent install. Integrate

• First Launch — What happens the first time you open timvim, and how to find your way around. Explore

• Dashboard — The alpha start screen, its Kartoza banner and the actions it offers. Discover

Recommended reading order

1. Installation — get it running.
2. First Launch — orient yourself.
3. Dashboard — learn the start screen.
4. Home Manager — make it permanent.