darkhelm/notifications-admin
1
0
Fork 0
mirror of https://github.com/GSA/notifications-admin.git synced 2026-09-09 02:53:11 -04:00
Code Issues Packages Projects Releases Wiki Activity

Updated README to include USWDS instructions

Browse Source
This commit is contained in:
Jonathan Bobel
2023-04-24 15:52:38 -04:00
parent 232a9ea24f
commit a73d53dd78
1 changed files with 34 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
README.md
View File

@@ -16,9 +16,9 @@ The [Notify API](https://github.com/GSA/notifications-api) provides the UI's bac
### Common steps ### Common steps
1. Install pre-requisites for setup: 1. Install pre-requisites for setup:
* [jq](https://stedolan.github.io/jq/): `brew install jq` - [jq](https://stedolan.github.io/jq/): `brew install jq`
* [terraform](https://www.terraform.io/): `brew install terraform` or `brew install tfenv` and use `tfenv` to install `terraform ~> 1.4.0` - [terraform](https://www.terraform.io/): `brew install terraform` or `brew install tfenv` and use `tfenv` to install `terraform ~> 1.4.0`
* [cf-cli@8](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html): `brew install cloudfoundry/tap/cf-cli@8` - [cf-cli@8](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html): `brew install cloudfoundry/tap/cf-cli@8`
1. [Log into cloud.gov](https://cloud.gov/docs/getting-started/setup/#set-up-the-command-line): `cf login -a api.fr.cloud.gov --sso` 1. [Log into cloud.gov](https://cloud.gov/docs/getting-started/setup/#set-up-the-command-line): `cf login -a api.fr.cloud.gov --sso`
1. Ensure you have access to the `notify-local-dev` and `notify-staging` spaces in cloud.gov 1. Ensure you have access to the `notify-local-dev` and `notify-staging` spaces in cloud.gov
1. Run the API setup steps 1. Run the API setup steps
@@ -53,6 +53,7 @@ The [Notify API](https://github.com/GSA/notifications-api) provides the UI's bac
If you are using VS Code, there are also instructions for [running inside Docker](./docs/docker-remote-containers.md) If you are using VS Code, there are also instructions for [running inside Docker](./docs/docker-remote-containers.md)
## To test the application ## To test the application
From a terminal within the running devcontainer: From a terminal within the running devcontainer:
``` ```
@@ -69,9 +70,25 @@ To run a specific JavaScript test, you'll need to copy the full command from `pa
Unlike most of the tests and scans, pa11y-ci cannot currently be run from within the VSCode dev container. 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 1. `make run-flask` from within the devcontainer
2. Run `make a11y-scan` from your host computer. 2. Run `make a11y-scan` from your host computer.
## Building USWDS
This only has to be done once
- Run `npx gulp init` This command will add all the USWDS assets to the directories from gulpfile.js, add a project Sass entry point, and compile USWDS into CSS.
This should be done when you want to compile your sass and icons
- `npx gulp compile`
This command can be used as you're doing local development, as it compiles, then recompiles when there are changes to Sass files in paths.dist.sass and paths.src.projectSass
- `npx gulp watch`
Other compile commands can be found at the [Getting started for developers](https://designsystem.digital.gov/documentation/getting-started-for-developers/) section from the USWDS documentation. You'll mostly need to reference [Phase 2](https://designsystem.digital.gov/documentation/getting-started/developers/phase-two-compile/)
## Further docs from UK ## Further docs from UK
- [Working with static assets](docs/static-assets.md) - [Working with static assets](docs/static-assets.md)