Signs UI

Web interface for MBTA countdown signs. Acts as an emulator for the physical hardware, providing real-time feedback on the current sign content. Also provides controls for modifying the sign configuration file, which can be used to override their behavior.

Prerequisites

• asdf
• direnv

Development

• Run asdf install from the repository root.
  • Note: If running macOS Sonoma on an Apple Silicon (ARM) machine, use KERL_CONFIGURE_OPTIONS="--disable-jit" asdf install¹
• Install Elixir dependencies with mix deps.get
• Install JS dependencies with pushd assets && npm install && popd
• Copy .envrc.template to .envrc, then edit .envrc and make sure all required environment variables are set. When finished, run direnv allow to activate them.
• Start the server with mix run --no-halt

Now you can visit localhost:5000 from your browser.

Developing locally with realtime_signs

See the realtime_signs README for instructions.

Footnotes

1. The way memory is allocated for the JIT in OTP 25 is prohibited in macOS Sonomoa. Disabling the JIT fixes the issue. This has been fixed in OTP-25.3.2.7 and beyond. ↩