Notify UI

This is the Notify front-end for government users and admins. To see it in action, check out the demo site (contact team for credentials).

Through the interface, users can:

• Register and manage users
• Create and manage services
• Send batch SMS by uploading a CSV
• View their history of notifications

The Notify API provides the UI's backend and is required for most things to function. Set that up first!

Local setup

Common steps

1. Install pre-requisites for setup:

   • jq: brew install jq
   • terraform: brew install terraform or brew install tfenv and use tfenv to install terraform ~> 1.4.0
   • cf-cli@8: brew install cloudfoundry/tap/cf-cli@8

2. Log into cloud.gov: cf login -a api.fr.cloud.gov --sso

3. Ensure you have access to the notify-local-dev and notify-staging spaces in cloud.gov

4. Run the API setup steps

5. Run the development terraform with:

    ```
    $ cd terraform/development
    $ ./run.sh
    ```
   

6. If you want to send data to New Relic from your local develpment environment, set NEW_RELIC_LICENSE_KEY within .env

7. Follow the instructions for either Direct installation or Docker installation below

Direct installation

1. Get the API running

2. Install pipenv

3. Install Python and Node dependencies

   make bootstrap

4. Run the Flask server

   make run-flask

5. Go to http://localhost:6012

Docker installation

If you are using VS Code, there are also instructions for running inside Docker

To test the application

From a terminal within the running devcontainer:

# run all the tests
make test

# continuously run js tests
npm run test-watch

To run a specific JavaScript test, you'll need to copy the full command from package.json.

Running a11y-scans locally

Unlike most of the tests and scans, pa11y-ci cannot currently be run from within the VSCode dev container.

1. Run make run-flask from within the devcontainer
2. Run make a11y-scan from your host computer.

Further docs from UK

• Working with static assets
• JavaScript documentation
• Updating dependencies

License && public domain

Work through commit 543be77 is licensed by the UK government under the MIT license. Work after that commit is in the worldwide public domain. See LICENSE.md for more information.

Contributing

As stated in CONTRIBUTING.md, all contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

About the TTS Public Benefits Studio

The Public Benefits Studio is a team inside of GSA’s Technology Transformation Services (TTS), home to innovative programs like 18F and Login.gov. We collaborate with benefits programs to develop shared technology tools and best practices that reduce the burden of navigating government programs for low income individuals and families.

We’re a cross-functional team of technologists with specialized experience working across public benefits programs like Medicaid, SNAP, and unemployment insurance.

For more information on what we're working on, the Notify tool, and how to get involved with our team, see our flyer.