garn.io

What It Is

garn is a Nix-based developer tool that lets you describe project environments, checks, and scripts declaratively in garn.ts. It focuses on solving problems such as inconsistent local Node/Go/formatter versions, repeated CI debugging, and scripts that only work on one particular machine. Unlike Docker or Vagrant, garn uses the Nix store to provide dependencies, while scripts and checks run natively on the host machine, avoiding the extra overhead of virtual machines or containers on non-Linux hosts.

Core Capabilities

In terms of functionality, garn can manage development dependencies such as compilers, code generators, formatters, test runners, and linters, and lets you enter the encapsulated environment with garn enter. It supports defining reproducible checks via addCheck, so results run locally can stay consistent with GitHub CI such as garnix. It also supports adding deterministic scripts with addExecutable, for use cases such as development servers, packaging, formatting, or code generation. At present, it explicitly supports Go, Npm, and Haskell, making it suitable for unifying toolchains in multi-language projects, though language coverage remains relatively limited.

API, Integrations, and Documentation

garn is configured through a TypeScript-style API, such as mkNpmProject, mkGoProject, mkHaskellProject, withDevTools, and addCheck. garn.ts is powered by Deno and can be configured with the Deno LSP; garn edit can also download and launch a preconfigured VSCodium. In the broader ecosystem, it depends on Nix, nixpkgs, and the Garnix cache, and provides Bash, Zsh, and Fish shell completions. The documentation covers installation, uninstallation, updates, manual installation, tutorials, concepts, and the TypeScript API, with plenty of examples and a clear onboarding path.

Pricing and Open-Source Information

The main content does not provide information on pricing, paid plans, commercial support, or SLAs. Whether it is open source is also not stated directly in the text, but the installation method references github:garnix-io/garn and a GitHub entry point is provided.

Pros, Cons, and Best-Fit Users

Its strengths are strong reproducibility, the ability to unify development environments without containers, friendliness to multi-language monorepos, and reduced differences between CI and local development. Its drawbacks are that it depends on Nix, which introduces learning and installation costs for teams; it currently only explicitly supports Go, Npm, and Haskell; and sandbox checks cannot access the internet by default. It is better suited to teams that care about engineering consistency and are willing to adopt Nix, and less suitable for small projects that only need simple language package management.

Access from China

The main content does not provide information about network access, mirrors, or payment options for mainland China, so access status is considered unknown. If access to Nix, GitHub, or external caches is unstable, a proxy or internal cache may be required. Alternative approaches include Docker, Vagrant, Nix flakes, direnv, Devbox, and devenv.