docs: add minimal constructor example (#2102)

Co-authored-by: Ruben Arts <[email protected]>

examples/constructor-minimal/.gitignore

@@ -0,0 +1,4 @@
+specs/
+dist/
+build/
+construct.yaml

examples/constructor-minimal/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, prefix.dev GmbH
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

examples/constructor-minimal/README.md

@@ -0,0 +1,21 @@
+# Constructor Minimal Example
+
+This demo shows how to use `pixi` to generate explicit `conda` environment specs,
+and [`constructor`][constructor] to use these specs to build platform-specific,
+offline-ready installers.
+
+## How to use?
+
+Make sure you have `pixi` available in your terminal.
+
+Navigate to this directory and run:
+
+```shell
+# Build the installer
+pixi run build
+
+# Install the built installer
+pixi run start
+```
+
+[constructor]: https://conda.github.io/constructor

examples/constructor-minimal/installer/construct.yaml.in

@@ -0,0 +1,16 @@
+# see https://github.com/conda/constructor/blob/main/CONSTRUCT.md
+name: MySimpleInstaller
+version: 0.1.0
+company: My Company
+license_file: ../LICENSE
+
+channels:
+  - conda-forge
+
+write_condarc: True
+initialize_conda: True
+initialize_by_default: False
+
+virtual_specs:
+  - __glibc >=2.17  # [linux]
+  - __osx >=10.13   # [osx]