Working instructions with mismatched Tailwind/esbuild

Author: camelpunch

README.md

@@ -0,0 +1,75 @@
+# Start a new Phoenix project with Nix
+
+## Prerequisites
+
+- Nix
+- Local Postgres
+- (optional) [direnv](https://direnv.net/)
+
+### direnv
+
+Examples assume you've set this up. Use `nix develop .` instead of `direnv allow` if you don't want direnv.
+
+To install with Home Manager and nix-direnv caching:
+
+```nix
+home.direnv = {
+  enable = true;
+  nix-direnv.enable = true;
+};
+```
+
+## Instructions
+
+### Initialise
+
+```shell
+mkdir my_new_project # underscores mean you can skip an argument to mix phx.new
+cd my_new_project
+git init
+nix flake init -t github:code-supply/nix-phoenix
+direnv allow
+mix phx.new . # and say Y to everything
+echo .direnv >> .gitignore # we don't want to store the direnv cache in git
+```
+
+### Add deps_nix
+
+Follow the [deps_nix installation instructions](https://github.com/code-supply/deps_nix?tab=readme-ov-file#installation).
+
+Fetch the deps_nix dependency:
+
+```shell
+mix deps.get
+```
+
+### Generate the initial deps.nix file
+
+```shell
+mix deps.nix
+```
+
+### Build the project
+
+```shell
+git add . # make files available to the Nix flake
+nix build --print-build-logs # short option is -L
+```
+
+### Create a local database
+
+```shell
+DATABASE_URL=ecto://postgres:postgres@localhost/my_new_project \
+MIX_ENV=prod \
+mix ecto.create
+```
+
+### Run the built artifact
+
+```shell
+DATABASE_URL=ecto://postgres:postgres@localhost/my_new_project \
+PHX_SERVER=true \
+RELEASE_COOKIE=asdf \
+SECRET_KEY_BASE="$(mix phx.gen.secret)" \
+./result/bin/my_new_project start
+```

flake-template/flake.nix

@@ -29,5 +29,42 @@
             };
         }
       );
+
+      packages = forAllSystems (
+        { pkgs, ... }:
+        let
+          mixNixDeps = pkgs.callPackages ./deps.nix { };
+        in
+        {
+          default =
+            with pkgs;
+            beamPackages.mixRelease {
+              inherit mixNixDeps;
+              pname = "my_phoenix_app";
+              src = ./.;
+              version = "0.0.0";
+
+              DATABASE_URL = "";
+              SECRET_KEY_BASE = "";
+
+              postBuild = ''
+                tailwind_path="$(mix do \
+                  app.config --no-deps-check --no-compile, \
+                  eval 'Tailwind.bin_path() |> IO.puts()')"
+                esbuild_path="$(mix do \
+                  app.config --no-deps-check --no-compile, \
+                  eval 'Esbuild.bin_path() |> IO.puts()')"
+
+                ln -sfv ${tailwindcss}/bin/tailwindcss "$tailwind_path"
+                ln -sfv ${esbuild}/bin/esbuild "$esbuild_path"
+                ln -sfv ${mixNixDeps.heroicons} deps/heroicons
+
+                mix do \
+                  app.config --no-deps-check --no-compile, \
+                  assets.deploy --no-deps-check
+              '';
+            };
+        }
+      );
     };
 }