How to develop

Contents

How to develop#

Enter a development shell environment:

nix develop

Alternatively, use direnv to automatically launch the environment when entering Forge source code directory:

echo -e "watch_dir flake/develop/\nuse nix" >.envrc # or cp .envrc.example .envrc

direnv allow

Note that to save on download bandwidth and disk size, we support different types of shells depending on the required task:

  • minimal: only required tools

  • ui: minimal with local UI development tools

  • ci: minimal with CI/CD tools and checks

  • default: all tools

To activate one of those shells, run:

nix develop .#devShells.<system>.<shell-name>

UI development#

Launch development server with automatic rebuild on change:

dev-ui

Stop the services by pressing Ctrl-C.

You can supervise those services with:

systemctl --user status ngi_nix_dev-'*'.service

For convenience systemd-manager-tui is also provisioned by the development shell to do the same.

Contents