No description
Find a file
2025-12-20 21:27:10 +01:00
cells docs: write docs, add README 2025-12-20 21:27:10 +01:00
docs docs: write docs, add README 2025-12-20 21:27:10 +01:00
lib feat: add support for wildcards (*) in filter & select 2025-09-24 20:26:18 +02:00
.envrc chore: update direnvrc 2025-08-26 12:56:44 +02:00
.gitignore feat: add devshell and improve input handling of cells 2025-08-06 10:13:34 +02:00
.gitlab-ci.yml chore: add CI 2025-09-17 14:30:50 +02:00
flake.lock chore: remove lib attr in flake and expose functions directly 2025-08-14 11:38:53 +02:00
flake.nix chore: add CI 2025-09-17 14:30:50 +02:00
README.md docs: write docs, add README 2025-12-20 21:27:10 +01:00

Rensa

Rensa is a powerful and flexible Nix flake framework designed to organize your Nix projects into logical units called "Cells". It is heavily inspired by divnix/std but aims to provide a streamlined experience. Feel free to check out std's awesome docs too.

Features

  • Cells: Organize your code into functional domains (e.g., backend, frontend, devops).
  • Blocks: Define types of outputs within a cell (e.g., packages, devShells, nixosConfigurations).
  • Actions: Integrate with the CLI to run commands defined in your cells.
  • Cell Flakes: Each cell can be its own flake, allowing for modular dependency management.

Quick Start

  1. Initialize a Flake: Create a flake.nix that uses rensa.
  2. Define Cells: Create a cells/ directory.
  3. Add Blocks: Add .nix files in your cells to define outputs.

Example flake.nix

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable";
    ren.url = "gitlab:rensa-nix/core";
  };

  outputs = {ren, ...}@inputs: ren.buildWith {
    inherit inputs;
    cellsFrom = ./cells;
    cellBlocks = with ren.blocks; [
      (simple "packages")
      (simple "devShells")
    ];
  } {
    packages = ren.select inputs.self [
      ["my-cell" "packages"]
    ];
  };
}

See the docs for more.