Skip to content

mibmo/conch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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!)