{"apps": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of applications.", "loc": ["perSystem", "forge", "apps"], "readOnly": false, "type": "list of (submodule)"}, "apps.*.description": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "This option has no description.", "loc": ["perSystem", "forge", "apps", "*", "description"], "readOnly": false, "type": "string"}, "apps.*.displayName": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"my-application\""}, "description": "Human readable application name. Defaults to `name` if not set.", "loc": ["perSystem", "forge", "apps", "*", "displayName"], "readOnly": false, "type": "string"}, "apps.*.icon": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Path to application icon (SVG file). If not specified, a default icon will be used.", "example": {"_type": "literalExpression", "text": "./icon.svg"}, "loc": ["perSystem", "forge", "apps", "*", "icon"], "readOnly": false, "type": "null or absolute path"}, "apps.*.links": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Links related to this project", "loc": ["perSystem", "forge", "apps", "*", "links"], "readOnly": false, "type": "submodule"}, "apps.*.links.docs": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Project documentation.", "loc": ["perSystem", "forge", "apps", "*", "links", "docs"], "readOnly": false, "type": "null or ((submodule) or string convertible to it)"}, "apps.*.links.docs.description": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "long-form description of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "docs", "description"], "readOnly": false, "type": "null or string"}, "apps.*.links.docs.text": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\u2039name\u203a\""}, "description": "link text", "loc": ["perSystem", "forge", "apps", "*", "links", "docs", "text"], "readOnly": false, "type": "string"}, "apps.*.links.docs.url": {"declarations": [], "description": "URL of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "docs", "url"], "readOnly": false, "type": "string matching the pattern [a-zA-Z][a-zA-Z0-9+-.]*://[^ \t\n]+"}, "apps.*.links.source": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Project source code.", "loc": ["perSystem", "forge", "apps", "*", "links", "source"], "readOnly": false, "type": "null or ((submodule) or string convertible to it)"}, "apps.*.links.source.description": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "long-form description of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "source", "description"], "readOnly": false, "type": "null or string"}, "apps.*.links.source.text": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\u2039name\u203a\""}, "description": "link text", "loc": ["perSystem", "forge", "apps", "*", "links", "source", "text"], "readOnly": false, "type": "string"}, "apps.*.links.source.url": {"declarations": [], "description": "URL of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "source", "url"], "readOnly": false, "type": "string matching the pattern [a-zA-Z][a-zA-Z0-9+-.]*://[^ \t\n]+"}, "apps.*.links.website": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Project website.", "loc": ["perSystem", "forge", "apps", "*", "links", "website"], "readOnly": false, "type": "null or ((submodule) or string convertible to it)"}, "apps.*.links.website.description": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "long-form description of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "website", "description"], "readOnly": false, "type": "null or string"}, "apps.*.links.website.text": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\u2039name\u203a\""}, "description": "link text", "loc": ["perSystem", "forge", "apps", "*", "links", "website", "text"], "readOnly": false, "type": "string"}, "apps.*.links.website.url": {"declarations": [], "description": "URL of the linked resource", "loc": ["perSystem", "forge", "apps", "*", "links", "website", "url"], "readOnly": false, "type": "string matching the pattern [a-zA-Z][a-zA-Z0-9+-.]*://[^ \t\n]+"}, "apps.*.name": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"my-application\""}, "description": "This option has no description.", "loc": ["perSystem", "forge", "apps", "*", "name"], "readOnly": false, "type": "string"}, "apps.*.ngi": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "NGI-specific options.", "loc": ["perSystem", "forge", "apps", "*", "ngi"], "readOnly": false, "type": "submodule"}, "apps.*.ngi.grants": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "NGI grants supporting this project.", "loc": ["perSystem", "forge", "apps", "*", "ngi", "grants"], "readOnly": false, "type": "submodule"}, "apps.*.ngi.grants.Commons": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "subgrants under the Commons fund", "loc": ["perSystem", "forge", "apps", "*", "ngi", "grants", "Commons"], "readOnly": false, "type": "list of string"}, "apps.*.ngi.grants.Core": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "subgrants under the Core fund", "loc": ["perSystem", "forge", "apps", "*", "ngi", "grants", "Core"], "readOnly": false, "type": "list of string"}, "apps.*.ngi.grants.Entrust": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "subgrants under the Entrust fund", "loc": ["perSystem", "forge", "apps", "*", "ngi", "grants", "Entrust"], "readOnly": false, "type": "list of string"}, "apps.*.ngi.grants.Review": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "subgrants under the Review fund", "loc": ["perSystem", "forge", "apps", "*", "ngi", "grants", "Review"], "readOnly": false, "type": "list of string"}, "apps.*.programs": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Programs shell configuration.", "loc": ["perSystem", "forge", "apps", "*", "programs"], "readOnly": false, "type": "submodule"}, "apps.*.programs.components": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Program components.", "example": {"_type": "literalExpression", "text": "{\n  default = {\n    packages = [ pkgs.curl ];\n  };\n}\n"}, "loc": ["perSystem", "forge", "apps", "*", "programs", "components"], "readOnly": false, "type": "attribute set of (submodule)"}, "apps.*.programs.components.<name>.packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "This option has no description.", "loc": ["perSystem", "forge", "apps", "*", "programs", "components", "<name>", "packages"], "readOnly": false, "type": "list of package"}, "apps.*.programs.runtimes": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Program runtimes.", "loc": ["perSystem", "forge", "apps", "*", "programs", "runtimes"], "readOnly": false, "type": "submodule"}, "apps.*.programs.runtimes.shell.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Programs bundle output.\n.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "apps", "*", "programs", "runtimes", "shell", "enable"], "readOnly": false, "type": "boolean"}, "apps.*.services": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Portable services configuration.", "loc": ["perSystem", "forge", "apps", "*", "services"], "readOnly": false, "type": "submodule"}, "apps.*.services.components": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Portable service components.", "example": {"_type": "literalExpression", "text": "{\n  service1 = {\n    command = pkgs.mypkgs.service1;\n  };\n  service2 = {\n    command = pkgs.mypkgs.service2;\n  };\n}\n"}, "loc": ["perSystem", "forge", "apps", "*", "services", "components"], "readOnly": false, "type": "attribute set of (submodule)"}, "apps.*.services.components.<name>.argv": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of arguments that will be passed to the main program.", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "argv"], "readOnly": false, "type": "list of (optionally newline-terminated) single-line string"}, "apps.*.services.components.<name>.command": {"declarations": [], "description": "Main command to use for the service.", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "command"], "readOnly": false, "type": "package or string"}, "apps.*.services.components.<name>.configData": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Configuration data files for the service\n\nThese files are made available to the service and can be updated without restarting the service process, enabling configuration reloading.\nThe service manager implementation determines how these files are exposed to the service (e.g., via a specific directory path).\nThis path is available in the `path` sub-option for each `configData.<name>` entry.\n\nThis is particularly useful for services that support configuration reloading via signals (e.g., SIGHUP) or which pick up changes automatically, so that no downtime is required in order to reload the service.\n", "example": {"_type": "literalExpression", "text": "{\n  \"server.conf\" = {\n    text = ''\n      port = 8080\n      workers = 4\n    '';\n  };\n  \"ssl/cert.pem\" = {\n    source = ./cert.pem;\n  };\n}\n"}, "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData"], "readOnly": false, "type": "lazy attribute set of (submodule)"}, "apps.*.services.components.<name>.configData.<name>.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "true"}, "description": "Whether this configuration file should be generated.\nThis option allows specific configuration files to be disabled.\n", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData", "<name>", "enable"], "readOnly": false, "type": "boolean"}, "apps.*.services.components.<name>.configData.<name>.name": {"declarations": [], "description": "Name of the configuration file (relative to the service's configuration directory). Defaults to the attribute name.\n", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData", "<name>", "name"], "readOnly": false, "type": "string"}, "apps.*.services.components.<name>.configData.<name>.path": {"declarations": [], "description": "The actual path where this configuration file will be available.\nThis is determined by the service manager implementation.\n\nOn NixOS it is an absolute path.\nOther service managers may provide a relative path, in order to be unprivileged and/or relocatable.\n", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData", "<name>", "path"], "readOnly": true, "type": "string"}, "apps.*.services.components.<name>.configData.<name>.source": {"declarations": [], "description": "Path of the source file.", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData", "<name>", "source"], "readOnly": false, "type": "absolute path"}, "apps.*.services.components.<name>.configData.<name>.text": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Text content of the configuration file.", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "configData", "<name>", "text"], "readOnly": false, "type": "null or strings concatenated with \"\\n\""}, "apps.*.services.components.<name>.environment": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Environment variables.", "loc": ["perSystem", "forge", "apps", "*", "services", "components", "<name>", "environment"], "readOnly": false, "type": "list of string"}, "apps.*.services.runtimes": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Portable services runtimes.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes"], "readOnly": false, "type": "submodule"}, "apps.*.services.runtimes.container": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Container configuration.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container"], "readOnly": false, "type": "submodule"}, "apps.*.services.runtimes.container.composeFile": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Path to the application container's compose file.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "composeFile"], "readOnly": false, "type": "null or absolute path"}, "apps.*.services.runtimes.container.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable container image output.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "enable"], "readOnly": false, "type": "boolean"}, "apps.*.services.runtimes.container.imageConfig": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "OCI image configuration as specified in <https://specs.opencontainers.org/image-spec/config/#properties>.\n", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "imageConfig"], "readOnly": false, "type": "lazy attribute set of anything"}, "apps.*.services.runtimes.container.packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of packages to add to the container's `/bin` directory.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "packages"], "readOnly": false, "type": "list of package"}, "apps.*.services.runtimes.container.setup": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Script to run once at startup.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "setup"], "readOnly": false, "type": "string"}, "apps.*.services.runtimes.container.tag": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"latest\""}, "description": "Tag of the generated container.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "container", "tag"], "readOnly": false, "type": "string"}, "apps.*.services.runtimes.nixos": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "NixOS system configuration.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos"], "readOnly": false, "type": "submodule"}, "apps.*.services.runtimes.nixos.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable NixOS/VM output.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "enable"], "readOnly": false, "type": "boolean"}, "apps.*.services.runtimes.nixos.extraConfig": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "NixOS system configuration\n\nSee: https://search.nixos.org/options\n", "example": {"_type": "literalExpression", "text": "{\n  services.postgresql.enable = true;\n}\n"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "extraConfig"], "readOnly": false, "type": "module"}, "apps.*.services.runtimes.nixos.setup": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Script to run once at startup.", "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "setup"], "readOnly": false, "type": "string"}, "apps.*.services.runtimes.nixos.vm.cores": {"declarations": [], "default": {"_type": "literalExpression", "text": "4"}, "description": "Number of CPU cores available to VM.", "example": {"_type": "literalExpression", "text": "8"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "vm", "cores"], "readOnly": false, "type": "signed integer"}, "apps.*.services.runtimes.nixos.vm.diskSize": {"declarations": [], "default": {"_type": "literalExpression", "text": "4096"}, "description": "VM disk size in MiB.", "example": {"_type": "literalExpression", "text": "10240"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "vm", "diskSize"], "readOnly": false, "type": "signed integer"}, "apps.*.services.runtimes.nixos.vm.forwardPorts": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of ports to forward from host system to VM.\n\nFormat: HOST_PORT:VM_PORT\n", "example": {"_type": "literalExpression", "text": "[ \"10022:22\" \"5432:5432\" \"8000:80\" ]\n"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "vm", "forwardPorts"], "readOnly": false, "type": "list of string matching the pattern ^[0-9]*:[0-9]*$"}, "apps.*.services.runtimes.nixos.vm.memorySize": {"declarations": [], "default": {"_type": "literalExpression", "text": "2048"}, "description": "VM memory size in MiB.", "example": {"_type": "literalExpression", "text": "4096"}, "loc": ["perSystem", "forge", "apps", "*", "services", "runtimes", "nixos", "vm", "memorySize"], "readOnly": false, "type": "signed integer"}, "apps.*.test": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Test configuration.", "loc": ["perSystem", "forge", "apps", "*", "test"], "readOnly": false, "type": "submodule"}, "apps.*.test.packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Additional packages required for running tests.", "example": {"_type": "literalExpression", "text": "[ pkgs.curl pkgs.jq ]"}, "loc": ["perSystem", "forge", "apps", "*", "test", "packages"], "readOnly": false, "type": "list of package"}, "apps.*.test.script": {"declarations": [], "default": {"_type": "literalExpression", "text": "''\n  echo \"Test script\"\n''"}, "description": "Bash script to run application tests inside a NixOS machine.\n\nThe application's services are available in the machine.\nRun with: nix build .#<app>.test\n", "example": {"_type": "literalExpression", "text": "''\ncurl -f http://localhost:5000/users\n''\n"}, "loc": ["perSystem", "forge", "apps", "*", "test", "script"], "readOnly": false, "type": "string"}, "apps.*.usage": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Application usage description in markdown format.", "loc": ["perSystem", "forge", "apps", "*", "usage"], "readOnly": false, "type": "string"}, "packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of packages to include in forge.\n\nEach package uses one of the available builders.\nOnly one builder can be enabled per package by setting build.<builder>.enable = true.\n", "loc": ["perSystem", "forge", "packages"], "readOnly": false, "type": "list of (submodule)"}, "packages.*.build.debug": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Enable interactive package build environment for debugging.\n\nLaunch environment:\n```\nmkdir dev && cd dev\nnix develop .#<package>\n```\n\nand follow instructions.\n", "loc": ["perSystem", "forge", "packages", "*", "build", "debug"], "readOnly": false, "type": "boolean"}, "packages.*.build.extraAttrs": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "Expert option.\n\nSet extra Nix derivation attributes.\n", "example": {"_type": "literalExpression", "text": "{\n  preConfigure = \"export HOME=$(mktemp -d)\"\n  postInstall = \"rm $out/somefile.txt\"\n}\n"}, "loc": ["perSystem", "forge", "packages", "*", "build", "extraAttrs"], "readOnly": false, "type": "attribute set of anything"}, "packages.*.build.goPackageBuilder.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Go module builder for applications and libraries.\n\nUses buildGoModule from nixpkgs under the hood..", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "enable"], "readOnly": false, "type": "boolean"}, "packages.*.build.goPackageBuilder.ldflags": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Linker flags passed to the Go compiler.\n\nCommonly used to embed version information.\n", "example": {"_type": "literalExpression", "text": "[\n  \"-s\"\n  \"-w\"\n  \"-X main.version=1.0.0\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "ldflags"], "readOnly": false, "type": "list of string"}, "packages.*.build.goPackageBuilder.modRoot": {"declarations": [], "default": {"_type": "literalExpression", "text": "\".\""}, "description": "Relative path to the directory containing go.mod.\n\nUseful for monorepos where the Go module is not at the repository root.\n", "example": {"_type": "literalExpression", "text": "\"cmd/my-app\""}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "modRoot"], "readOnly": false, "type": "string"}, "packages.*.build.goPackageBuilder.packages.build": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Native build-time dependencies.\n\nUse this for tools needed during the build, such as pkg-config.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.pkg-config pkgs.installShellFiles ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "packages", "build"], "readOnly": false, "type": "list of package"}, "packages.*.build.goPackageBuilder.packages.check": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Test dependencies.\n\nPackages needed to run Go tests.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.gotestsum ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "packages", "check"], "readOnly": false, "type": "list of package"}, "packages.*.build.goPackageBuilder.packages.run": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Build and runtime dependencies for the target platform.\n\nUse this for libraries needed by cgo-enabled packages.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.openssl pkgs.sqlite ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "packages", "run"], "readOnly": false, "type": "list of package"}, "packages.*.build.goPackageBuilder.proxyVendor": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Fetch dependencies via the Go module proxy instead of vendoring from source.\n\nEnable this only when upstream vendoring is incomplete or unsuitable.\n", "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "proxyVendor"], "readOnly": false, "type": "boolean"}, "packages.*.build.goPackageBuilder.subPackages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[\n  \".\"\n]"}, "description": "List of Go packages to build.\n\nKeep the default for a single main package, or provide multiple package paths.\n", "example": {"_type": "literalExpression", "text": "[\n  \".\"\n  \"./cmd/tool\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "subPackages"], "readOnly": false, "type": "list of string"}, "packages.*.build.goPackageBuilder.tags": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Build tags passed to the Go compiler.", "example": {"_type": "literalExpression", "text": "[\n  \"sqlite\"\n  \"netgo\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "tags"], "readOnly": false, "type": "list of string"}, "packages.*.build.goPackageBuilder.vendorHash": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Hash of the vendored Go module dependency tree.\n\nLeave empty initially to let Nix print the correct hash on first build.\n", "loc": ["perSystem", "forge", "packages", "*", "build", "goPackageBuilder", "vendorHash"], "readOnly": false, "type": "null or string"}, "packages.*.build.pythonAppBuilder.disabledTests": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of pytest test names to skip.\n\nUseful for disabling flaky or network-dependent tests.\n", "example": {"_type": "literalExpression", "text": "[\n  \"test_network\"\n  \"test_integration\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "disabledTests"], "readOnly": false, "type": "list of string"}, "packages.*.build.pythonAppBuilder.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Python application builder for executable Python programs.\n\nUses buildPythonApplication which prevents the package from being used as a dependency.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "enable"], "readOnly": false, "type": "boolean"}, "packages.*.build.pythonAppBuilder.importsCheck": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of Python modules to verify can be imported after installation.\n\nThis provides a simple smoke test to ensure the package was built correctly.\n", "example": {"_type": "literalExpression", "text": "[\n  \"myapp\"\n  \"myapp.cli\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "importsCheck"], "readOnly": false, "type": "list of string"}, "packages.*.build.pythonAppBuilder.packages.build-system": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "PEP-517 build system dependencies.", "example": {"_type": "literalExpression", "text": "[ pkgs.python3Packages.setuptools pkgs.python3Packages.wheel ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "packages", "build-system"], "readOnly": false, "type": "list of package"}, "packages.*.build.pythonAppBuilder.packages.dependencies": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Runtime dependencies (PEP-621).", "example": {"_type": "literalExpression", "text": "[ pkgs.python3Packages.click pkgs.python3Packages.requests ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "packages", "dependencies"], "readOnly": false, "type": "list of package"}, "packages.*.build.pythonAppBuilder.packages.optional-dependencies": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "PEP-621 optional dependencies (extras).\n\nThese are additional dependencies that can be installed optionally.\n", "example": {"_type": "literalExpression", "text": "{\n  dev = [ pkgs.python3Packages.pytest ];\n  redis = [ pkgs.python3Packages.redis ];\n}\n"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "packages", "optional-dependencies"], "readOnly": false, "type": "attribute set of list of package"}, "packages.*.build.pythonAppBuilder.relaxDeps": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Remove version constraints from specified dependencies.\n\nUse when the package requires specific versions but works fine with versions in nixpkgs.\nSet to true to relax all dependencies, or provide a list of dependency names.\n", "example": {"_type": "literalExpression", "text": "[\n  \"click\"\n  \"attrs\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonAppBuilder", "relaxDeps"], "readOnly": false, "type": "boolean or list of string"}, "packages.*.build.pythonPackageBuilder.disabledTests": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of pytest test names to skip.\n\nUseful for disabling flaky or network-dependent tests.\n", "example": {"_type": "literalExpression", "text": "[\n  \"test_network\"\n  \"test_integration\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "disabledTests"], "readOnly": false, "type": "list of string"}, "packages.*.build.pythonPackageBuilder.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Python package builder for reusable Python libraries.\n\nUses buildPythonPackage which allows the package to be used as a dependency by other packages.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "enable"], "readOnly": false, "type": "boolean"}, "packages.*.build.pythonPackageBuilder.importsCheck": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of Python modules to verify can be imported after installation.\n\nThis provides a simple smoke test to ensure the package was built correctly.\n", "example": {"_type": "literalExpression", "text": "[\n  \"requests\"\n  \"requests.auth\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "importsCheck"], "readOnly": false, "type": "list of string"}, "packages.*.build.pythonPackageBuilder.packages.build-system": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "PEP-517 build system dependencies.", "example": {"_type": "literalExpression", "text": "[ pkgs.python3Packages.setuptools pkgs.python3Packages.wheel ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "packages", "build-system"], "readOnly": false, "type": "list of package"}, "packages.*.build.pythonPackageBuilder.packages.dependencies": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Runtime dependencies (PEP-621).", "example": {"_type": "literalExpression", "text": "[ pkgs.python3Packages.numpy pkgs.python3Packages.attrs ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "packages", "dependencies"], "readOnly": false, "type": "list of package"}, "packages.*.build.pythonPackageBuilder.packages.optional-dependencies": {"declarations": [], "default": {"_type": "literalExpression", "text": "{ }"}, "description": "PEP-621 optional dependencies (extras).\n\nThese are additional dependencies that can be installed optionally.\n", "example": {"_type": "literalExpression", "text": "{\n  dev = [ pkgs.python3Packages.pytest ];\n  redis = [ pkgs.python3Packages.redis ];\n}\n"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "packages", "optional-dependencies"], "readOnly": false, "type": "attribute set of list of package"}, "packages.*.build.pythonPackageBuilder.relaxDeps": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Remove version constraints from specified dependencies.\n\nUse when the package requires specific versions but works fine with versions in nixpkgs.\nSet to true to relax all dependencies, or provide a list of dependency names.\n", "example": {"_type": "literalExpression", "text": "[\n  \"click\"\n  \"attrs\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "pythonPackageBuilder", "relaxDeps"], "readOnly": false, "type": "boolean or list of string"}, "packages.*.build.rustPackageBuilder.cargoBuildFlags": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Additional flags to pass to cargo build.\n", "example": {"_type": "literalExpression", "text": "[\n  \"--release\"\n  \"--features enable-feature\"\n]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "cargoBuildFlags"], "readOnly": false, "type": "list of string"}, "packages.*.build.rustPackageBuilder.cargoHash": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "SHA256 hash of the Cargo.lock file or source.\n\nFor git sources without Cargo.lock, this is the source hash.\nLeave empty initially - nix will provide the correct hash on first build.\n", "example": {"_type": "literalExpression", "text": "\"sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\""}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "cargoHash"], "readOnly": false, "type": "string"}, "packages.*.build.rustPackageBuilder.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Rust package builder for reusable Rust crates.\n\nUses rustPlatform.buildRustPackage.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "enable"], "readOnly": false, "type": "boolean"}, "packages.*.build.rustPackageBuilder.packages.build": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Build-time dependencies (native architecture).\n\nTools needed during compilation that run on the build machine.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.pkg-config pkgs.rustPlatform.bindgenHook ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "packages", "build"], "readOnly": false, "type": "list of package"}, "packages.*.build.rustPackageBuilder.packages.check": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Test dependencies.\n\nPackages needed to run Rust tests.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.cargo-nextest ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "packages", "check"], "readOnly": false, "type": "list of package"}, "packages.*.build.rustPackageBuilder.packages.run": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Runtime dependencies (target architecture).\n\nLibraries needed by the package at runtime.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.openssl pkgs.sqlite pkgs.libopus ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "rustPackageBuilder", "packages", "run"], "readOnly": false, "type": "list of package"}, "packages.*.build.standardBuilder.enable": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Whether to enable Standard builder for autotools, CMake, or Makefile-based projects.\n\nAutomatically handles configure, build, and install phases.", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "build", "standardBuilder", "enable"], "readOnly": false, "type": "boolean"}, "packages.*.build.standardBuilder.packages.build": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Build-time dependencies (native architecture).\n\nTools needed during compilation that run on the build machine.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.cmake pkgs.pkg-config pkgs.ninja ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "standardBuilder", "packages", "build"], "readOnly": false, "type": "list of package"}, "packages.*.build.standardBuilder.packages.check": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Test dependencies.\n\nPackages needed to run tests.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.cunit ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "standardBuilder", "packages", "check"], "readOnly": false, "type": "list of package"}, "packages.*.build.standardBuilder.packages.run": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Runtime dependencies (target architecture).\n\nLibraries needed by the package at runtime.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.openssl pkgs.sqlite pkgs.zlib ]"}, "loc": ["perSystem", "forge", "packages", "*", "build", "standardBuilder", "packages", "run"], "readOnly": false, "type": "list of package"}, "packages.*.description": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Package description.", "example": {"_type": "literalExpression", "text": "\"A program that prints greeting messages\""}, "loc": ["perSystem", "forge", "packages", "*", "description"], "readOnly": false, "type": "string"}, "packages.*.development.packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Additional packages to include in the development environment.\n\nAll build inputs are automatically included.\n", "example": {"_type": "literalExpression", "text": "[ pkgs.git pkgs.vim ]"}, "loc": ["perSystem", "forge", "packages", "*", "development", "packages"], "readOnly": false, "type": "list of package"}, "packages.*.development.shellHook": {"declarations": [], "default": {"_type": "literalExpression", "text": "''\n  echo -e \"\\nWelcome. This environment contains all dependencies required\"\n  echo \"to build $DEVENV_PACKAGE_NAME from source.\"\n  echo\n  echo \"Grab the source code from $DEVENV_PACKAGE_SOURCE\"\n  echo \"or from the upstream repository and you are all set to start hacking.\"\n''"}, "description": "Bash script to run when entering the development environment.\n\nEnter with: nix develop .#<package>\n", "example": {"_type": "literalExpression", "text": "''\necho \"Welcome to my-package development environment!\"\necho \"Run 'make' to build the project\"\n''\n"}, "loc": ["perSystem", "forge", "packages", "*", "development", "shellHook"], "readOnly": false, "type": "string"}, "packages.*.homePage": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Package home page URL.", "example": {"_type": "literalExpression", "text": "\"https://www.gnu.org/software/hello/hello-2.12.1.tar.gz\""}, "loc": ["perSystem", "forge", "packages", "*", "homePage"], "readOnly": false, "type": "string"}, "packages.*.license": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "License, or licenses, for the package.", "example": {"_type": "literalExpression", "text": "lib.licenses.gpl3Only"}, "loc": ["perSystem", "forge", "packages", "*", "license"], "readOnly": false, "type": "(attribute set) or string or list of ((attribute set) or string)"}, "packages.*.mainProgram": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"my-program\""}, "description": "Name of the main executable program.", "example": {"_type": "literalExpression", "text": "\"hello\""}, "loc": ["perSystem", "forge", "packages", "*", "mainProgram"], "readOnly": false, "type": "string"}, "packages.*.name": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"my-package\""}, "description": "Package name.", "example": {"_type": "literalExpression", "text": "\"hello\""}, "loc": ["perSystem", "forge", "packages", "*", "name"], "readOnly": false, "type": "string"}, "packages.*.source.git": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Git repository URL with revision.\n\nFormats:\n  - platform:owner/repo/revision\n  - git:url?tag=version\n  - git:url?rev=hash\n", "example": {"_type": "literalExpression", "text": "\"github:my-user/my-repo/v1.0.0\""}, "loc": ["perSystem", "forge", "packages", "*", "source", "git"], "readOnly": false, "type": "null or string matching the pattern ^.*:.*/.*/.*$"}, "packages.*.source.hash": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"\""}, "description": "Source code hash.\n\nUse empty string to get the hash during a first build.\n", "example": {"_type": "literalExpression", "text": "\"sha256-jZkUKv2SV28wsM18tCqNxoCZmLxdYH2Idh9RLibH2yA=\""}, "loc": ["perSystem", "forge", "packages", "*", "source", "hash"], "readOnly": false, "type": "string"}, "packages.*.source.patches": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "List of patch files to apply to the source code.\n\nPatches are applied in the order specified using the patch command.\n", "example": {"_type": "literalExpression", "text": "[ ./fix-build.patch ./add-feature.patch ]"}, "loc": ["perSystem", "forge", "packages", "*", "source", "patches"], "readOnly": false, "type": "list of absolute path"}, "packages.*.source.path": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Relative path to local source code directory.", "example": {"_type": "literalExpression", "text": "./backend/src"}, "loc": ["perSystem", "forge", "packages", "*", "source", "path"], "readOnly": false, "type": "null or absolute path"}, "packages.*.source.submodules": {"declarations": [], "default": {"_type": "literalExpression", "text": "false"}, "description": "Fetch git submodules along with the repository source.\n\nOnly applicable when using `source.git`.\n", "example": {"_type": "literalExpression", "text": "true"}, "loc": ["perSystem", "forge", "packages", "*", "source", "submodules"], "readOnly": false, "type": "boolean"}, "packages.*.source.url": {"declarations": [], "default": {"_type": "literalExpression", "text": "null"}, "description": "Source tarball URL.", "example": {"_type": "literalExpression", "text": "\"https://downloads.my-project/my-package-1.0.0.tar.gz\""}, "loc": ["perSystem", "forge", "packages", "*", "source", "url"], "readOnly": false, "type": "null or string matching the pattern ^.*://.*"}, "packages.*.test.packages": {"declarations": [], "default": {"_type": "literalExpression", "text": "[ ]"}, "description": "Additional packages required for running tests.", "example": {"_type": "literalExpression", "text": "[ pkgs.curl pkgs.jq ]"}, "loc": ["perSystem", "forge", "packages", "*", "test", "packages"], "readOnly": false, "type": "list of package"}, "packages.*.test.script": {"declarations": [], "default": {"_type": "literalExpression", "text": "''\n  echo \"Test script\"\n''"}, "description": "Bash script to run package tests.\n\nThe package being tested is available in PATH.\nRun with: nix build .#<package>.test\n", "example": {"_type": "literalExpression", "text": "''\nhello | grep \"Hello, world\"\n''\n"}, "loc": ["perSystem", "forge", "packages", "*", "test", "script"], "readOnly": false, "type": "string"}, "packages.*.version": {"declarations": [], "default": {"_type": "literalExpression", "text": "\"1.0.0\""}, "description": "Package version.", "example": {"_type": "literalExpression", "text": "\"2.12.1\""}, "loc": ["perSystem", "forge", "packages", "*", "version"], "readOnly": false, "type": "string"}}