meta/README.md

38 lines
1.4 KiB
Markdown
Raw Normal View History

# Recycled Cloud Management Interface
2020-12-15 08:45:34 +01:00
This repository tracks the initial work for a web interface atop the recycled
cloud. It is written in [Elixir](https://elixir-lang.org/), making use of the
[Phoenix Web Framework](https://www.phoenixframework.org/).
## Notes
* The (Phoenix) project has been initialized with the `--no-webpack` and
`--no-dashboard` flags to avoid unnecessary clutter. We can add them back
later if needed!
## Getting Started
You'll need Erlang/OTP and elixir installed on your system. It usually boils
down to installing the `elixir` package of your distribution. Once done, you
can:
2020-12-15 08:45:34 +01:00
* Install dependencies with `mix deps.get`
* Create and migrate your database with `mix ecto.setup`
- You'll need PostgreSQL here. I (tfloure) usually run it in an isolated
container with something along the lines of `podman run --rm -it -e
POSTGRES_HOST_AUTH_METHOD=trust --expose 5432 -p 5432:5432
postgres:latest`.
2020-12-15 08:45:34 +01:00
* Start Phoenix endpoint with `mix phx.server`
Now you can visit [`localhost:4000`](http://localhost:4000) from your browser.
## Useful Resources
2020-12-15 08:45:34 +01:00
Phoenix Web Framework:
2020-12-15 08:45:34 +01:00
* 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