Flake Parts - Revision history

Malix: add benefit

2025-09-14T16:54:29Z

add benefit

← Older revision		Revision as of 16:54, 14 September 2025
Line 1:		Line 1:
	[https://github.com/hercules-ci/flake-parts Flake Parts] is a framework that leverages the NixOS [[NixOS modules\|module system]] to write modular and organized [[flakes]]. It provides options that represent standard flake attributes and establishes an easy way to work with <code>system</code>. It is a minimal and very lightweight mirror of the flake schema.		[https://github.com/hercules-ci/flake-parts Flake Parts] is a framework that leverages the NixOS [[NixOS modules\|module system]] to write modular and organized [[flakes]]. It provides options that represent standard flake attributes and establishes an easy way to work with <code>system</code>. It is a minimal and very lightweight mirror of the flake schema.

	The major benefit of flake-parts is being able to write modular flakes with the full power of the module system. It is a great option and alternative to [https://github.com/numtide/flake-utils flake-utils], a wrapper which is largely [https://ayats.org/blog/no-flake-utils discouraged] from being used.		The major benefit of flake-parts is being able to write modular flakes with the full power of the module system, with error handled. It is a great option and alternative to [https://github.com/numtide/flake-utils flake-utils], a wrapper which is largely [https://ayats.org/blog/no-flake-utils discouraged] from being used.

	There is documentation available for a variety of flake-parts powered modules available on https://flake.parts.		There is documentation available for a variety of flake-parts powered modules available on https://flake.parts.

Pigs: Add category flakes

2025-05-18T05:07:27Z

Add category flakes

← Older revision		Revision as of 05:07, 18 May 2025
Line 88:		Line 88:

	* [https://flake.parts/ Introduction] - flake-parts		* [https://flake.parts/ Introduction] - flake-parts

			[[Category:Flakes]]

Frontear: explicitly note documentation on main page

2024-08-05T22:02:24Z

explicitly note documentation on main page

← Older revision		Revision as of 22:02, 5 August 2024
Line 2:		Line 2:

	The major benefit of flake-parts is being able to write modular flakes with the full power of the module system. It is a great option and alternative to [https://github.com/numtide/flake-utils flake-utils], a wrapper which is largely [https://ayats.org/blog/no-flake-utils discouraged] from being used.		The major benefit of flake-parts is being able to write modular flakes with the full power of the module system. It is a great option and alternative to [https://github.com/numtide/flake-utils flake-utils], a wrapper which is largely [https://ayats.org/blog/no-flake-utils discouraged] from being used.

			There is documentation available for a variety of flake-parts powered modules available on https://flake.parts.

	== Getting Started ==		== Getting Started ==

Frontear: clarify flake output

2024-08-05T21:59:56Z

clarify flake output

← Older revision		Revision as of 21:59, 5 August 2024
Line 35:		Line 35:

	flake = {		flake = {
	# ~~A fallback attribute for non-system specific~~		# The usual flake attributes can be defined here, including
	# ~~flake attributes (like check, formatter, nixosConfigurations, etc)~~		# system-agnostic and/or arbitrary outputs.
	};		};

Frontear: add an example of a flake-parts module

2024-08-05T21:54:15Z

add an example of a flake-parts module

@@ Line 43: / Line 43: @@
    };
+}
 </syntaxhighlight>

Frontear: Introduce flake-parts to the wiki, and exemplify its power while providing a little more explanation than what the flake-parts webpage itself provides.

2024-08-05T21:42:36Z

Introduce flake-parts to the wiki, and exemplify its power while providing a little more explanation than what the flake-parts webpage itself provides.

New page

[https://github.com/hercules-ci/flake-parts Flake Parts] is a framework that leverages the NixOS [[NixOS modules|module system]] to write modular and organized [[flakes]]. It provides options that represent standard flake attributes and establishes an easy way to work with <code>system</code>. It is a minimal and very lightweight mirror of the flake schema.

The major benefit of flake-parts is being able to write modular flakes with the full power of the module system. It is a great option and alternative to [https://github.com/numtide/flake-utils flake-utils], a wrapper which is largely [https://ayats.org/blog/no-flake-utils discouraged] from being used.

== Getting Started ==
It is very easy to introduce flake-parts into your already existing <code>flake.nix</code>, or to a completely new project as well. A minimal template is provided below:<syntaxhighlight lang="nix">
{
description = "Your new project, powered by flake-parts!";

inputs = {
flake-parts.url = "github:hercules-ci/flake-parts";
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable"; # This should point to whichever nixpkgs rev you want.
};

outputs = { flake-parts, ... } @ inputs: flake-parts.lib.mkFlake { inherit inputs; } {
imports = [
# ./module.nix
# inputs.foo.flakeModule
];

perSystem = { config, self', inputs', pkgs, system, ... }: {
# Allows definition of system-specific attributes
# without needing to declare the system explicitly!
#
# Quick rundown of the provided arguments:
# - config is a reference to the full configuration, lazily evaluated
# - self' is the outputs as provided here, without system. (self'.packages.default)
# - inputs' is the input without needing to specify system (inputs'.foo.packages.bar)
# - pkgs is an instance of nixpkgs for your specific system
# - system is the system this configuration is for

# This is equivalent to packages.<system>.default
packages.default = pkgs.hello;
};

flake = {
# A fallback attribute for non-system specific
# flake attributes (like check, formatter, nixosConfigurations, etc)
};

# Declared systems that your flake supports. These will be enumerated in perSystem
systems = [ "x86_64-linux" "aarch64-linux" "x86_64-darwin" "aarch64-darwin" ];
};
}
</syntaxhighlight>

== See also ==

* [https://flake.parts/ Introduction] - flake-parts