Merge pull request #245 from flox/preview

chore: release 1.4.4

Author: mkenigs

.flox/env/manifest.lock

@@ -70,19 +70,18 @@
     {
       "attr_path": "lychee",
       "broken": false,
-      "derivation": "/nix/store/yn4ww3n519ih2rmvzpi28l437gr1nrb8-lychee-0.18.1.drv",
+      "derivation": "/nix/store/f1lm1lhz491jy5zkps4jnwbwfpsa1zj8-lychee-0.18.1.drv",
       "description": "Fast, async, stream-based link checker written in Rust",
       "install_id": "lychee",
       "license": "[ Apache-2.0, MIT ]",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "lychee-0.18.1",
       "pname": "lychee",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:21:35.834229Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:22:08.174057Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -91,7 +90,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/1nq2rk1yr7ax6m2fq13f6f1flkb9pkxc-lychee-0.18.1"
+        "out": "/nix/store/lnk75z6jmx6i28rvqfh83b5xgfyzl3cg-lychee-0.18.1"
       },
       "system": "aarch64-darwin",
       "group": "lint",
@@ -100,19 +99,18 @@
     {
       "attr_path": "lychee",
       "broken": false,
-      "derivation": "/nix/store/kqfyqlyga7bams4w7596x8ydkh1jsn18-lychee-0.18.1.drv",
+      "derivation": "/nix/store/40jmikmqpyfhm825fd57hxsys4gy8nx3-lychee-0.18.1.drv",
       "description": "Fast, async, stream-based link checker written in Rust",
       "install_id": "lychee",
       "license": "[ Apache-2.0, MIT ]",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "lychee-0.18.1",
       "pname": "lychee",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:40:22.807118Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:40:38.013718Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -121,7 +119,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/2b63yc2y94f1a9h0a3pr4kiw4pkvkb8b-lychee-0.18.1"
+        "out": "/nix/store/zvpnq6h7xj60rravhx7ww0r0pnd1zylg-lychee-0.18.1"
       },
       "system": "aarch64-linux",
       "group": "lint",
@@ -130,19 +128,18 @@
     {
       "attr_path": "lychee",
       "broken": false,
-      "derivation": "/nix/store/i85gjm7kxv5ap10sdxsh6k91665r4lvw-lychee-0.18.1.drv",
+      "derivation": "/nix/store/s211plxjn8mqsvzzcya8k7qzlky96qp3-lychee-0.18.1.drv",
       "description": "Fast, async, stream-based link checker written in Rust",
       "install_id": "lychee",
       "license": "[ Apache-2.0, MIT ]",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "lychee-0.18.1",
       "pname": "lychee",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:56:46.837607Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:56:42.234221Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -151,7 +148,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/b1ir1ig8clagkm725722cz21ny4145qz-lychee-0.18.1"
+        "out": "/nix/store/va4zh2s1yyypa0hpsvv3c1s4hz01nfs5-lychee-0.18.1"
       },
       "system": "x86_64-darwin",
       "group": "lint",
@@ -160,19 +157,18 @@
     {
       "attr_path": "lychee",
       "broken": false,
-      "derivation": "/nix/store/ac12zx9ilw6a7fsd2z6swfa6k3sc9hss-lychee-0.18.1.drv",
+      "derivation": "/nix/store/02p3vrgc28ibzi336vkvfb9zp9pbzgna-lychee-0.18.1.drv",
       "description": "Fast, async, stream-based link checker written in Rust",
       "install_id": "lychee",
       "license": "[ Apache-2.0, MIT ]",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "lychee-0.18.1",
       "pname": "lychee",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T05:18:49.123968Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T05:16:18.584659Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -181,7 +177,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/9hvgbrhwgcl1bkd3rfdphcgb8m837zgw-lychee-0.18.1"
+        "out": "/nix/store/rd34jv78ns93kbh5rhf836b5v03yjv8m-lychee-0.18.1"
       },
       "system": "x86_64-linux",
       "group": "lint",
@@ -190,19 +186,18 @@
     {
       "attr_path": "markdownlint-cli2",
       "broken": false,
-      "derivation": "/nix/store/kx3bpp24sm9cvk4cwz7v5wrsxdzy26w6-markdownlint-cli2-0.17.2.drv",
+      "derivation": "/nix/store/fj6swxrnac1r9pjimkzngi55s9yjyqd1-markdownlint-cli2-0.17.2.drv",
       "description": "Fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the markdownlint library",
       "install_id": "markdownlint-cli2",
       "license": "MIT",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "markdownlint-cli2-0.17.2",
       "pname": "markdownlint-cli2",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:21:35.915308Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:22:08.256187Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -211,7 +206,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/qb9y2z6lhkys13m4dpzdv6ncc60j6yzx-markdownlint-cli2-0.17.2"
+        "out": "/nix/store/9xbp4s27kv3c3w9hvvj66ryicb53yvc9-markdownlint-cli2-0.17.2"
       },
       "system": "aarch64-darwin",
       "group": "lint",
@@ -220,19 +215,18 @@
     {
       "attr_path": "markdownlint-cli2",
       "broken": false,
-      "derivation": "/nix/store/rvc0yj411n2hb4jrswilq91llal6522z-markdownlint-cli2-0.17.2.drv",
+      "derivation": "/nix/store/8sizyy1hp494ihzj4wd6b0br7b7vhd2g-markdownlint-cli2-0.17.2.drv",
       "description": "Fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the markdownlint library",
       "install_id": "markdownlint-cli2",
       "license": "MIT",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "markdownlint-cli2-0.17.2",
       "pname": "markdownlint-cli2",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:40:22.991139Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:40:38.197426Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -241,7 +235,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/gcxh0d3xmxsnmw9cn860g921mnic8vaa-markdownlint-cli2-0.17.2"
+        "out": "/nix/store/rzh3hqy4ss4mwcpzx54wa2hnca2ji89g-markdownlint-cli2-0.17.2"
       },
       "system": "aarch64-linux",
       "group": "lint",
@@ -250,19 +244,18 @@
     {
       "attr_path": "markdownlint-cli2",
       "broken": false,
-      "derivation": "/nix/store/5lhpq3df4ycxbv235zalgm5zw4gfzy5h-markdownlint-cli2-0.17.2.drv",
+      "derivation": "/nix/store/c2av3vi7sp1hxw7ywg659vzi15n8wa9l-markdownlint-cli2-0.17.2.drv",
       "description": "Fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the markdownlint library",
       "install_id": "markdownlint-cli2",
       "license": "MIT",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "markdownlint-cli2-0.17.2",
       "pname": "markdownlint-cli2",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T04:56:46.914907Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T04:56:42.311783Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -271,7 +264,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/lli9s2svr212px4n7wjd72k083v4v4qy-markdownlint-cli2-0.17.2"
+        "out": "/nix/store/lld0jmwiagwhlas6wqmnpd536h0n5z0g-markdownlint-cli2-0.17.2"
       },
       "system": "x86_64-darwin",
       "group": "lint",
@@ -280,19 +273,18 @@
     {
       "attr_path": "markdownlint-cli2",
       "broken": false,
-      "derivation": "/nix/store/lm68zhvpkf5ic48g00wcp43b5xxdpyz5-markdownlint-cli2-0.17.2.drv",
+      "derivation": "/nix/store/vj1w6fc6700i7lwi79y2jcghfl6w2gfh-markdownlint-cli2-0.17.2.drv",
       "description": "Fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the markdownlint library",
       "install_id": "markdownlint-cli2",
       "license": "MIT",
-      "locked_url": "https://github.com/flox/nixpkgs?rev=adaa24fbf46737f3f1b5497bf64bae750f82942e",
+      "locked_url": "https://github.com/flox/nixpkgs?rev=2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
       "name": "markdownlint-cli2-0.17.2",
       "pname": "markdownlint-cli2",
-      "rev": "adaa24fbf46737f3f1b5497bf64bae750f82942e",
-      "rev_count": 799423,
-      "rev_date": "2025-05-13T23:30:50Z",
-      "scrape_date": "2025-05-16T05:18:49.331114Z",
+      "rev": "2795c506fe8fb7b03c36ccb51f75b6df0ab2553f",
+      "rev_count": 803506,
+      "rev_date": "2025-05-20T12:29:04Z",
+      "scrape_date": "2025-05-24T05:16:18.796487Z",
       "stabilities": [
-        "staging",
         "unstable"
       ],
       "unfree": false,
@@ -301,7 +293,7 @@
         "out"
       ],
       "outputs": {
-        "out": "/nix/store/yk2b9sdcp30c7w2lfzi9xn1nqvr4frfp-markdownlint-cli2-0.17.2"
+        "out": "/nix/store/j5w86cms22n63fc086mx9a45bv77r7cv-markdownlint-cli2-0.17.2"
       },
       "system": "x86_64-linux",
       "group": "lint",

FLOX_VERSION

@@ -1 +1 @@
-1.4.3
+1.4.4

docs/concepts/activation.md

@@ -325,6 +325,6 @@ that prepare your environment just how you like them.
 
 [environment-concept]: ./services.md
 [bash-func-export]: https://www.gnu.org/software/bash/manual/html_node/Bourne-Shell-Builtins.html#index-export
-[vars-section]: ../concepts/manifest.md#vars-section
-[hook-section]: ../concepts/manifest.md#hook-section
-[profile-section]: ../concepts/manifest.md#profile-section
+[vars-section]: ../reference/command-reference/manifest.toml.md#vars
+[hook-section]: ../reference/command-reference/manifest.toml.md#hook
+[profile-section]: ../reference/command-reference/manifest.toml.md#profile

docs/concepts/environments.md

@@ -50,51 +50,48 @@ sharing and working with different types of environments.
 A Flox environment stores its metadata, declarative manifest, and manifest lock
 file in a `.flox` directory wherever the [`flox init`][flox_init] command was
 run.
+All of these files can be stored in version control when working with path environments.
+
 Let's look closer at the files that were generated.
 
-### Environment manifest: `.flox/env/manifest.toml`
+### `manifest.toml`
+
+The manifest is a declarative specification for the environment which is [TOML][toml_spec] formatted.
 
-The manifest is a declarative specification for the environment and contains 5
-parts:
+The best way to edit the manifest is by running [`flox edit`][flox_edit] which will launch your default editor and run validation when you save changes.
 
-- **Install:** the packages installed to the environment.
-- **Vars:** environment variables for use in the activated environment.
-- **Hook:** Bash script executed before passing control to the user's shell.
-- **Profile:** Shell-specific scripts sourced by the user's shell.
-- **Options:** Environment-scoped options such as supported systems.
+See [`manifest.toml`][manifest] for a complete description of the manifest format and the [customizing environments guide][customizing_environments_guide] to walk through examples.
 
-**[Read more about the manifest][manifest_concept]** and consult the
-[customizing environments guide][customizing_environments_guide] to walk through
-examples.
+```toml title="manifest.toml"
+version  = 1
+
+[install]
+nodejs.pkg-path = "nodejs_24"
+```
 
-### Manifest lock: `.flox/env/manifest.lock`
+### `manifest.lock`
 
-The lock file serves as a snapshot of the specific versions of dependencies that
-were built and activated at a particular point in time.
+The lock file serves as a snapshot of the specific package versions and their dependencies that were built and activated at a particular point in time.
+Flox manages this file for you.
 
 ``` json title="manifest.lock"
 {
-  "lockfile-version": 0,
- ...
-        "input": {
-          "attrs": {
-            "lastModified": 1703581207,
-            "narHash": "3ef...",
-            "owner": "NixOS",
-            "repo": "nixpkgs",
-            "rev": "3ef...",
-            "type": "github"
-          },
-          "fingerprint": "3ef...",
-          "url": "github:NixOS/nixpkgs/3ef..."
-        },
-        "priority": 5
+  …
+  "packages": [
+    {
+      "install_id": "nodejs",
+      "version": "24.0.1",
+      "system": "aarch64-darwin",
+      "outputs": {
+        "dev": "/nix/store/by9av8x8vmk8lpw4cxhhxfbf7s1h4xzx-nodejs-24.0.1-dev",
+        "libv8": "/nix/store/li49fpxxlgzaz20sahhfj6n8cbkqi7m1-nodejs-24.0.1-libv8",
+        "out": "/nix/store/naafq480zhq05xbi2d3kzpnna2rdqsfb-nodejs-24.0.1"
       },
-      "nodejs": {    
+  …
 }
 ```
 
-### Environment metadata: `.flox/env.json`
+### `env.json`
 
 A metadata file that contains the name of the environment and the environment's
 version. Flox manages this file for you.
@@ -119,6 +116,7 @@ version. Flox manages this file for you.
 [create_guide]: ../tutorials/creating-environments.md
 [customizing_environments_guide]: ../tutorials/customizing-environments.md
 [generation_concept]: ./generations.md
-[manifest_concept]: ./manifest.md
 [floxhub_concept]: ./floxhub.md
 [discourse]: https://discourse.flox.dev/
+[manifest]: ../reference/command-reference/manifest.toml.md
+[toml_spec]: https://toml.io/en/v1.0.0

docs/concepts/flox-vs-containers.md

@@ -447,6 +447,6 @@ you need to build a container so that it can be deployed.
 [activate]: ../reference/command-reference/flox-activate.md
 [services-start]: ../reference/command-reference/flox-services-start.md
 [services]: ../concepts/services.md
-[manifest]: ../concepts/manifest.md
+[manifest]: ../concepts/environments.md#manifesttoml
 [early]: https://flox.dev/early/
 [ci-cd]: ../tutorials/ci-cd.md

docs/concepts/floxhub.md

@@ -105,5 +105,5 @@ Run the [`flox auth logout`][flox_auth] command.
 [flox_install]: ../reference/command-reference/flox-install.md
 [flox_uninstall]: ../reference/command-reference/flox-uninstall.md
 [generation_concept]: ../concepts/generations.md
-[manifest_concept]: ../concepts/manifest.md
+[manifest_concept]: ../concepts/environments.md#manifesttoml
 [environments_concept]: ../concepts/environments.md