https://github.com/mbta/signs_ui

User Interface to interact with countdown signs
https://github.com/mbta/signs_ui

Last synced: about 1 month ago
JSON representation

User Interface to interact with countdown signs

• Host: GitHub
• URL: https://github.com/mbta/signs_ui
• Owner: mbta
• Created: 2018-05-14T19:54:06.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-11-08T22:34:50.000Z (about 2 months ago)
• Last Synced: 2024-11-08T23:24:15.623Z (about 2 months ago)
• Language: TypeScript
• Size: 3.3 MB
• Stars: 3
• Watchers: 24
• Forks: 1
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# 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](https://asdf-vm.com/)

* [direnv](https://direnv.net/)

## 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`[^1]

* 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`](http://localhost:5000) from your browser.

### Developing locally with [realtime_signs](https://github.com/mbta/realtime_signs)

See the realtime_signs README for instructions.

[^1]: The way memory is allocated for the JIT in OTP 25 is prohibited in macOS Sonomoa. [Disabling the JIT fixes the issue](https://github.com/erlang/otp/issues/7687#issuecomment-1737184968). This has [been fixed in OTP-25.3.2.7](https://github.com/erlang/otp/commit/ac591a599b09b48b45a7125aa30ec5419ba3cc2f) and beyond.