This project uses: Elixir version 1.4.x
wkhtmltopdf version 0.12.4
(Can be installed with brew install brew install Caskroom/cask/wkhtmltopdf
on mac)
- Ensure you have the above dependencies installed
- Ensure you have the following environment variables in your path:
export POSTGRES_USERNAME=<psql_username>
export POSTGRES_PASSWORD=<psql_password>
export SMTP_USERNAME=AKIAJTAJDKM4LEZYXFUA
export SMTP_PASSWORD=As1PNrgowukauAigSvNBFXgHuqGShjcC9PRV7zzW3XJr
export SES_SERVER=email-smtp.eu-west-1.amazonaws.com
export SES_PORT=25
export [email protected]
export ADMIN_PASSWORD=inclusiveclassrooms123
export REDIS_URL=redis://localhost:6379
export SECRET_KEY_BASE=RoBmHpD9fll4Z+i9J/yort8U3AEelmCaphcUmQBHlimDvAeGmdzxYuVrL7BbsczP
- Start a postgres server in a seperate terminal with:
$ postgres -D /usr/local/var/postgres
- Start a redis server in a seperate terminal with:
$ redis-server
- Install dependencies with
mix deps.get
- Create and migrate your database with
mix ecto.create && mix ecto.migrate
- Install Node.js dependencies with
npm install
- Start your phoenix server with
mix phoenix.server
- Now visit
localhost:4000
from your browser.
NOTE: If you are experiencing errors when trying to run the project then it might be because of the following:
.env
file isn't sourced. Quick fix: typesource .env
into the command line at the root of your projectpsql
isn't running. Quick fix: start apsql
server in your terminal
- To run the tests locally ensure you have run the above quick start steps
- Run the test script with
mix test
- You can check test coverage with
mix coveralls
- You can generate a coverage report with
mix coveralls.html
Check the application routes with mix pheonix.routes
You can view further technical documentation by running:
mix docs
Then opening the generated html file
open docs/index.html