bootstrap-lix

Quickly and reproducibly install Lix inside GitHub Actions by pinning static closures in your flake.nix.

Usage

Add bootstrap-lix to your flake.nix as follows:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs?ref=nixos-unstable";
    bootstrap-lix.url = "github:stainless-em/bootstrap-lix";
  };

  outputs = { nixpkgs, bootstrap-lix, ... }:
    assert bootstrap-lix.lib.assertBootstrap {
      inherit nixpkgs;
      paths = "";
    };
    {
      # ... your flake outputs here ...
    }
}

Next, evaluate the flake with nix flake show, and you will be prompted to update the paths attribute.

GitHub Action

Add the action to your workflow:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: stainless-em/bootstrap-lix@main
      - run: nix develop

The action reads flake.nix and downloads and installs the referenced closure from cache.nixos.org.

Local development

• pnpm install to fetch dependencies
• pnpm run build to bundle src/index.ts into dist/index.js
• pnpm test to test bootstrapping in a Docker container
• pnpm fmt to run prettier