···4repo. Generally:
56* Pipelines are defined in YAML.
7-* Dependencies can be specified from
8-[Nixpkgs](https://search.nixos.org) or custom registries.
9-* Environment variables can be set globally or per-step.
000000000000000000000001011Here's an example that uses all fields:
12
···4repo. Generally:
56* Pipelines are defined in YAML.
7+* Workflows can run using different *engines*.
8+9+The most barebones workflow looks like this:
10+11+```yaml
12+when:
13+ - event: ["push"]
14+ branch: ["main"]
15+16+engine: "nixery"
17+18+# optional
19+clone:
20+ skip: false
21+ depth: 50
22+ submodules: true
23+```
24+25+The `when` and `engine` fields are required, while every other aspect
26+of how the definition is parsed is up to the engine. Currently, a spindle
27+provides at least one of these built-in engines:
28+29+## `nixery`
30+31+The Nixery engine uses an instance of [Nixery](https://nixery.dev) to run
32+steps that use dependencies from [Nixpkgs](https://github.com/NixOS/nixpkgs).
3334Here's an example that uses all fields:
35