conch 🐚

Leveraging the power of Nix modules for powerful environment-specific shells to suit your project.

Usage

Setting up a generic environment for working with Node is as simple as running nix flake init --template github:mibmo/conch#node-pnpm or placing a flake.nix at the root of your project directory.

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
    conch = {
      url = "github:mibmo/conch";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
  outputs = { conch, ... }:
    conch.load [ "x86_64-linux" ] ({ ... }: {
      development.node = {
        enable = true;
        pnpm.enable = true;
      };
    });
}

Entering the environment by running nix develop.

A full list of the modules and their options are available at mibmo.github.io/conch/search

NOTE: Conch's nixpkgs input should follow your own! Otherwise things may break or in general just not work as expected. The examples follow best practices and should be referred to.

Missing something?

Open an issue!

Contributing

Conch is far from complete and the internals are likely to change a lot, but contributions are always welcome! (especially of the module variety!)