Garching's hottest new tool to find friends while eating.
- Cool and responsive web interface
- Current mensa menu with food ratings
- Private groups for friend groups, clubs, ...
- API for (Discord) Bots like WoBot
- Elixir and Phoenix for the backend
- HEEx (HTML + Embedded Elixir) and TailwindCSS for the frontend
- Run
mix setupto install and setup dependencies - Start the Phoenix server with
mix phx.serveror inside IEx withiex -S mix phx.server
Now you can visit localhost:4000 from your browser.
Authentication is done via Discord, so you'll need to
- Setup an Application
- Add
http://localhost:4000/auth/discord/callbackto the OAuth2 -> Redirects. - Save the Client ID and Client Secret, you need to pass them as environment variables.
For example put them into a
.envfile and then runexport $(cat .env | xargs).
You can also use uberauth directly with your favorite
OpenID provider, add the strategy to mix.exs, configure it in config.exs and replace the sign-in link.
User ids < 10 are reserved, these ids can only be assigned via direct DB access. User 1 is considered admin and can access special pages like the Dashboard. User 2 is used for the API, for example groups created via the API are owned by User 2.
The API uses the environment variable API_TOKEN to authorize requests, they need to include it as a bearer token. In development mode it's automatically set to secret. If not set in production, the API is disabled (will always return Unauthorized).
Wherever you want, requirements: can run Elixir and has a database. You can also use the Docker (Compose) setup instead.
Example .env file with default values
# OAuth Credentials
export DISCORD_CLIENT_ID=''
export DISCORD_CLIENT_SECRET=''
# mix phx.gen.secret
export SECRET_KEY_BASE=''
# domain and port
export PHX_HOST='localhost'
export PORT='4000'
# already set in the compose yaml
#export DATABASE_URL=''
# see API
export API_TOKEN='secret'Phoenix includes Gettext. To update the translation files:
mix gettext.extract
mix gettext.merge priv/gettext