Wordcharts

Development

# start server on port 3000 (default)
docker-compose exec -w /app wordcharts npm --prefix frontend run dev
# start elixir backend on port 4000 (default)
docker-compose exec -w /app wordcharts mix phx.server

Translations

In case you add new translations:

First run extract, to extract new translations from javascript files to en language file:

docker-compose exec -w /app wordcharts npm --prefix frontend run extract

Then compile the language files, so it can be used by the app:

docker-compose exec -w /app wordcharts npm --prefix frontend run compile

Linting

docker-compose exec -w /app wordcharts bash
cd frontend
npx eslint .

Now you can visit localhost:3000 from your browser.

Production

docker-compose --file docker-compose-prod.yml --env-file .env.prod up -d --build --force-recreate

Now you can visit localhost:4000 from your browser.

Optional: Generate self-signed ssl sertificate for the postgres server on the host machine; the generated files are mounted into the docker container

mkdir -p ./ca
openssl req -new -text -passout pass:abcd -subj /CN=localhost -out ./ca/server.req -keyout ./ca/privkey.pem
openssl rsa -in ./ca/privkey.pem -passin pass:abcd -out ./ca/server.key
openssl req -x509 -in ./ca/server.req -text -key ./ca/server.key -out ./ca/server.crt
chmod 600 ./ca/server.key
test $(uname -s) = Linux && chown 70 ./ca/server.key

Learn more

Official website: https://www.phoenixframework.org/
Guides: https://hexdocs.pm/phoenix/overview.html
Docs: https://hexdocs.pm/phoenix
Forum: https://elixirforum.com/c/phoenix-forum
Source: https://github.com/phoenixframework/phoenix

Backup

To start your Phoenix server:

Install dependencies with mix deps.get
Create and migrate your database with mix ecto.setup
Start Phoenix endpoint with mix phx.server or inside IEx with iex -S mix phx.server