Templates for Sellout’s personal projects, plus a flake lib to make the templates as lightweight and easy to keep in sync as possible.
This also has devShells to make it easy to work on projects that don’t have a flake.
Some “template-y” files are instead in a community health file repository that’s shared by all repositories under the “sellout” user. Individual repositories may override these files as necessary, and repositories in a different org won’t benefit from the repository. Some of these files may eventually transition to templates (for example., CONTRIBUTING.md) if it’s deemed important for them to be part of the source tree.
Optional one-time setup (this gives you a shorthand for referencing the flake later):
nix registry add flaky github:sellout/flakyIf you omit this step, then replace flaky# in the examples with a concrete URL, usually github:sellout/flaky# (or ./path/to/flaky# if you have cloned the repository.
Or, if you have some other “system” flake that you do things from, then adding
{
outputs = inputs: {
…
templates = inputs.flaky.templates // { … };
…
};
inputs.flaky.url = "github:sellout/flaky";
}should allow you to replace flaky# with <some-flake># in the examples below. This is my preferred approach – where a single flake manages everything about my various systems.
This sets up a new project, with various services, etc. already configured.
mkdir -p <project-path>
cd <project-path>
git init
mkdir .config
curl https://raw.githubusercontent.com/sellout/flaky/main/templates/example.yaml \
>.config/mustache.yaml
git add .config/mustache.yaml
$EDITOR .config/mustache.yaml
nix run flaky#sync-templateThese flakes support direnv out of the box.
See the templates for more.
The devShells contain a much wider array of tooling to support most projects in any ecosystem.
cd <project-path>
nix develop flaky#<project-type>If you use direnv, adding nix develop flaky#<project-type> to a .envrc in the project-path should automate this for you.
NB: The default devShell doesn’t correspond to the default template. The default devShell is for developing this flake, while the default template is an alias for the nix template (and thus corresponds to the nix devShell).
We recommend the following steps to make working in this repository as easy as possible.
This command ensures that any work you do within this repository happens within a consistent reproducible environment. That environment provides various debugging tools, etc. When you leave this directory, you will leave that environment behind, so it doesn’t impact anything else on your system.
This will apply our repository-specific Git configuration to git commands run against this repository. It’s lightweight (you should definitely look at it before applying this command) – it does things like telling git blame to ignore formatting-only commits.
