bootstrap/specs/phoenix/template

Phoenix Flake Template

This is a template for constructing a environment for Elixir development (version 1.15.7, Erlang/OTP 25) with the Phoenix (version 1.7.10) framework. direnv can be used to launch a dev shell upon entering this directory (refer to .envrc). Otherwise run via:

$> nix develop

Quickstart

To begin, create a new database:

$> pg_ctl initdb

If the flake's default devShell is loaded, this will create a database cluster at $PWD/data. To start the database, run the following:

$> pg_ctl start -o --unix_socket_directories="$PGDATA"

To shut the database down, run:

$> pg_ctl stop

You can also specify a different location for the database cluster using the -D option in each of the above commands.

Afterward, you can run the Phoenix setup commands:

$> mix ecto.setup
$> mix assets.setup

and then start the local server:

$> mix phx.server

Language Server

The elixir-ls LSP (version 0.17.10) is included in this flake.

Dependencies

This project pins Mix dependencies using mix2nix. After updating your mix.lock file, make sure to re-run the following:

mix2nix > deps.nix

As of now, mix2nix cannot handle git dependencies found inside the mix.lock file. If you have git dependencies, add them manually or use FODs.