Skip to content

Creating Files

The files option allows you to declaratively create configuration files and scripts in your development environment. Files are automatically generated from structured data and symlinked into your project when entering the shell.

This is particularly useful for: - Generating configuration files from Nix data structures - Creating executable scripts - Setting up project-specific configurations - Ensuring consistent file contents across the team

Supported Formats

devenv supports multiple file formats out of the box:

  • json - JSON format
  • ini - INI format
  • yaml - YAML format
  • toml - TOML format
  • text - Plain text

Basic Examples

JSON Files

devenv.nix
{
  files."config.json".json = {
    database = {
      host = "localhost";
      port = 5432;
    };
    features = [ "auth" "api" "ui" ];
  };
}

This creates a config.json file: 

{
  "database": {
    "host": "localhost",
    "port": 5432
  },
  "features": ["auth", "api", "ui"]
}

YAML Files

devenv.nix
{
  files."docker-compose.yml".yaml = {
    version = "3.8";
    services = {
      web = {
        image = "nginx:latest";
        ports = [ "8080:80" ];
      };
    };
  };
}

TOML Files

devenv.nix
{
  files."config.toml".toml = {
    title = "My App Config";

    server = {
      host = "0.0.0.0";
      port = 8000;
    };
  };
}

INI Files

devenv.nix
{
  files."settings.ini".ini = {
    general = {
      debug = "true";
      log_level = "info";
    };
    database = {
      connection_string = "postgres://localhost/mydb";
    };
  };
}

Text Files

For plain text files, simply provide a string:

devenv.nix
{
  files."README.txt".text = ''
    This is a development environment.
    Run `devenv shell` to get started.
  '';
}

Executable Files

You can make any file executable by setting the executable attribute:

devenv.nix
{
  files."setup.sh" = {
    text = ''
      #!/bin/bash
      echo "Running setup..."
      npm install
    '';
    executable = true;
  };
}

This is particularly useful for: - Shell scripts that need to be executed - Custom tooling and utilities - Git hooks

Creating Files in Subdirectories

Files can be created in nested directories by specifying the path:

devenv.nix
{
  files = {
    ".config/app/settings.json".json = {
      theme = "dark";
    };

    "scripts/build.sh" = {
      text = "#!/bin/bash\nnpm run build";
      executable = true;
    };
  };
}

The parent directories will be created automatically if they don't exist.