Astro LSP Problem

[jojomoee]

Hello nvf community,

I'm new to nixOS/nvf but got the basics to work, now trying to add astro in my nvf.

Simply adding:
astro.enable = true;

gives me in nvim the following error:

Log:

[ERROR][2026-06-04 17:38:48] ...-unwrapped-0.12.2/share/nvim/runtime/lua/vim/lsp/log.lua:151 "rpc" "/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/bin/astro-ls" "stderr" "node:internal/modules/cjs/loader:1479\n throw err;\n ^\n\nError: Cannot find module 'typescript'\nRequire stack:\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/utils.js\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/codeActions.js\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/index.js\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/languageServerPlugin.js\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/nodeServer.js\n- /nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/bin/nodeServer.js\n at Module._resolveFilename (node:internal/modules/cjs/loader:1476:15)\n at wrapResolveFilename (node:internal/modules/cjs/loader:1049:27)\n at defaultResolveImplForCJSLoading (node:internal/modules/cjs/loader:1073:10)\n at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1094:12)\n at Module._load (node:internal/modules/cjs/loader:1262:25)\n at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)\n at Module.require (node:internal/modules/cjs/loader:1576:12)\n at require (node:internal/modules/helpers:153:16)\n at Object.<anonymous> (/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/utils.js:9:12)\n at Module._compile (node:internal/modules/cjs/loader:1830:14) {\n code: 'MODULE_NOT_FOUND',\n requireStack: [\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/utils.js',\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/codeActions.js',\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/plugins/typescript/index.js',\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/languageServerPlugin.js',\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/dist/nodeServer.js',\n '/nix/store/0gb474rzivla430d3f1ggd1lfz8c7ldg-astro-language-server-2.16.7/lib/node_modules/astro-language-server/packages/language-tools/language-server/bin/nodeServer.js'\n ]\n}\n\nNode.js v24.15.0\n"

AI said the main issue in the log is that the module for typescript cannot be found for astro. Furthermore astro is searching for node.
I installed nodjs, typescript-language-server, astro-language-server globally in my home.nix - im using home manager as module.

Here is my home.nix

home.nix

{ config, pkgs, inputs, ... }:

{

  imports = [];

  programs.bash.enable = true;

  sops = {
    age.keyFile = "/home/johannes/.config/sops/age/keys.txt";
    defaultSopsFile = ./secrets.yaml; 

    secrets = {
      git_name = {};
      git_email = {};
    };

    templates."git-secret".content = ''
      [user]
        name = "${config.sops.placeholder.git_name}"
        email = "${config.sops.placeholder.git_email}"
    '';
  };

  home.username = "johannes";
  home.homeDirectory = "/home/johannes";
  home.stateVersion = "26.05";

  home.packages = with pkgs; [
    #webdev
    nodejs_24
    typescript-language-server
    astro-language-server

    #utils
    tree
  ];
  fonts.fontconfig.enable = true;


  programs.git = {
    enable = true;
    settings = {
      include.path = config.sops.templates."git-secret".path;
    };
  };

  programs.direnv = {
    enable = true;
    nix-direnv.enable = true;
  };

  programs.nvf = {
    enable = true;
    enableManpages = true;

    settings = {
      vim = {
        clipboard.enable = true;
        clipboard.registers = "unnamedplus";
        clipboard.providers.wl-copy.enable = true;
        opts = {
          shiftwidth = 2;
        };

        autocomplete.nvim-cmp.enable = true;
        lsp.enable = true;

        languages = {
          enableTreesitter = true;
          nix.enable = true;
          html.enable = true;
          css.enable = true;
          typescript.enable = true;
          yaml.enable = true;
          astro.enable = true;

        };
          telescope.enable = true;
          mini.icons.enable = true;
      };
    };
  };
}

Flake:

flake.nix

{ description = "Nixos SurfaceBook2 and upcoming computer config";

inputs = {
  nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

  nixos-hardware = {
    url = "github:NixOS/nixos-hardware/master";
    };

  home-manager = {
    url = "github:nix-community/home-manager";
    inputs.nixpkgs.follows = "nixpkgs";
};

  nvf.url = "github:notashelf/nvf";

  sops-nix.url = "github:Mic92/sops-nix";
  sops-nix.inputs.nixpkgs.follows = "nixpkgs";


  };

  outputs = { self, nixpkgs, home-manager, nixos-hardware, sops-nix, nvf,  ...}@inputs: {
    nixosConfigurations = {
        
        #Surface-Profile
        surface = nixpkgs.lib.nixosSystem {
        system = "x86_64-linux";
        modules = [

            ./configuration.nix
            ./hardware-configuration.nix
            nixos-hardware.nixosModules.microsoft-surface-common
            sops-nix.nixosModules.sops
            home-manager.nixosModules.home-manager
	{
            home-manager.useGlobalPkgs = true;
            home-manager.useUserPackages = true;
	home-manager.extraSpecialArgs = { inherit inputs; };
            home-manager.users.johannes = ./home.nix;
            home-manager.sharedModules = [
	  nvf.homeManagerModules.default
              inputs.sops-nix.homeManagerModules.sops
            ];
	}
        ];
      };
    };
  };
}

Typescript support is working for example. Out of the box like it should, so nvf is doing its job

Also i need to note, that when i first added Astro it did work, but the next day it didn't maybe ive changed something and didnt notice. So im pretty sure the mistake is on my side on not with nvf

After investigating a bit i came across this issue:
neovim/nvim-lspconfig#4101

I was able to the Lua snippet, but as far is i know i would need to configure everything for astro which would then kind of defeat the whole concept of nvf.

I also made a normal nvim configuration to try if the astro lsp server is functioning, and i got it working.
But i would really prefer to use nvf.

Hope somebody can Help, Thanks in advance!
And sorry if Iv'e missed an discussion, manual explaining my problem!

[NotAShelf]

nvf provides the necessary instrumentation for overriding LSP server configurations and setting vim.globals with Nix. Using those two, you can override tsdk int Astro LSP's init options.

[jojomoee]

Thank you for the fast response!

Unfortunately i am a bit to unexperienced, to understand what is meant. My implementation would look like this, but it didnt solve anything.

Thank you for the help :)

settings = {
     vim = {
       globals = {
         astro_typescript =
           "${pkgs.typescript}/lib/node_modules/typescript/lib";
       };

       lsp = {
         enable = true;
         presets.astro-language-server.enable = true;
         servers.astro-langauge-server = {
           init_options = {
             typescript = {
               tsdk =
                 "${pkgs.typescript}/lib/node_modules/typescript/lib";
             };
           };

         };
       };

[NotAShelf]

Please check the generated Lua configuration, nvf-print-configuration should give you the generated Lua to investigate.

[jojomoee]

Had a typo servers.astro-lang au ge-server, some more problems after but was able to solve it.
I came up with this solution (AI supported haha) probably not the most elegant way:

    globals = {
      astro_typescript =
        "${pkgs.typescript}/lib/node_modules/typescript/lib";
    };

    lsp = {
      enable = true;
      presets.astro-language-server.enable = true;
      servers.astro-language-server = {
        cmd = pkgs.lib.mkForce [
          "${pkgs.coreutils}/bin/env"
          "NODE_PATH=${pkgs.typescript}/lib/node_modules"
          "${pkgs.astro-language-server}/bin/astro-ls"
          "--stdio"
        ];

        init_options.typescript = pkgs.lib.mkForce (
          lib.generators.mkLuaInline "{ tsdk = '${pkgs.typescript}/lib/node_modules/typescript/lib' }"

        );
      };
    };

Ive tested some basics but everything works smooth so far, thanks for pointing me in the right directions :)