matrix-media-expanded/README.md
2022-01-08 11:39:25 -05:00

2.2 KiB

haskell-template

Haskell project template optimized for a fully reproducible and friendly development environment. Based on Nix + Flakes + VSCode (HLS) + ormolu autoformatting + Relude as Prelude.

Getting Started

First-time setup:

To run the program with auto-recompile:

  • Press Ctrl+Shift+B in VSCode, or run bin/run (bin/run-via-tmux if you have tmux installed) in terminal, to launch Ghcid running your program.

Open Main.hs, and expect all HLS IDE features like hover-over tooltip to work out of the box. Try changing the source, and expect Ghcid to re-compile and re-run the app in the terminal below.


Renaming the project:

NAME=myproject
git mv haskell-template.cabal ${NAME}.cabal
nix run nixpkgs#sd -- haskell-template ${NAME} * */*
git add . && git commit -m rename
cd .. && mv haskell-template ${NAME} && cd ${NAME}

Tips

  • Run nix flake update to update all flake inputs. nixpkgs is pinned to a specific a rev, which you can advance to the latest rev reported in status.nixos.org.

Alternatives