np/templates/ed

Project Editor

A per-project Neovim wrapper built with nix-wrapper-modules and nvimConfig.

Setup

The flake provides two entry points:

Command	What you get
direnv allow / nix develop	(Recommended) A shell with nv and all enabled language toolchains (R, Python, Julia, Quarto) on PATH.
nix run	Launches only the nv editor. Language toolchains (R, Python, etc.) are not on PATH.

With direnv (recommended)

direnv allow   # enter the devShell automatically
nv             # launch the pre-configured Neovim
R              # R REPL is available (if enabled in flake.nix)

Without direnv

nix develop    # enter the devShell manually
nv             # launch Neovim
R              # R REPL is available (if enabled in flake.nix)

Why nix run only gives the editor: The flake's packages.default is the wrapped Neovim binary. Language toolchains (R, radian, quarto, etc.) live in devShells.default. Use nix develop (or direnv allow) to get the full environment.

Configuration

The flake.nix is the single source of truth. Key knobs:

Option	What it controls
cats	Toggle language support (nix, r, python, julia, etc.)
settings.lang_packages.<lang>	Language-specific packages installed in the wrapper
settings.colorscheme	Neovim colorscheme
settings.background	"dark" or "light"
settings.wrapRc	When true, init.lua is embedded (rebuild to change); when false, init.lua is external (reload without rebuild)
binName	The wrapper binary name (nv by default)
env	Environment variables set in the wrapper
extraPackages	Extra system packages available in the wrapper's PATH
specs.extraLua	Inject lazy.nvim plugin specs

Adding packages without editing flake.nix

Create any of these optional files in the project root to add dependencies without modifying flake.nix:

• python-packages.nix — receives python3Packages, return a list of packages:

  p: with p; [ numpy scipy ]
  

• r-packages.nix — receives rpkgs (includes rPackages), return a list:

  p: with p.rPackages; [ ggplot2 data.table ]
  

• julia-packages.nix — no arguments, return a list of package name strings:

  [ "DataFrames" "Plots" ]
  

Formatting

nix fmt

Uses nixfmt-rfc-style pinned via the flake's formatter output.