Skip to content

OHS TTA Project via ACF; Lead POC: Patrice Pascual and Ryan Ahearn

Notifications You must be signed in to change notification settings

raft-tech/Head-Start-TTADP

 
 

Repository files navigation

Office of Head Start Training & Technical Assistance Data Platform

Welcome to the home of the OHS TTADP.

What We're Building and Why

For the latest on our product mission, goals, initiatives, and KPIs, see the Product Planning page.

Getting Started

Make sure Docker is installed. To check run docker ps

Run yarn docker:deps. This builds the frontend and backend docker containers and install dependencies. You only need to run this step the first time you fire up the app and when dependencies are added/updated/removed. Running yarn docker:start starts the backend and frontend, browse to http://localhost:3000 to hit the frontend and http://localhost:3000/api to hit the backend. Copying .env.example to .env, substituting in your user id and group id will cause any files created in docker containers to be owned by your user on your host.

You can also run build commands directly on your host (without docker). Make sure you install dependencies when changing execution method. You could see some odd errors if you install dependencies for docker and then run yarn commands directly on the host, especially if you are developing on windows. If you want to use the host yarn commands be sure to run yarn deps before any other yarn commands. Likewise if you want to use docker make sure you run yarn docker:deps.

The frontend proxies requests to paths it doesn't recognize to the backend.

Running Tests

Run yarn docker:deps to install dependencies. Run yarn docker:test to run all tests for the frontend and backend.

Docker on Windows

You may run into some issues running the docker commands on Windows:

  • If you run into Permission Denied errors see this issue
  • You can try to speed up execution time on windows with solutions posted to this issue

Other Commands

Yarn Command Description
yarn docker:deps Install dependencies for the frontend and backend
yarn docker:start Starts the backend and frontend docker containers
yarn docker:stop Stops the backend and frontend docker containers
yarn docker:test Runs tests for the frontend and backend in docker containers
yarn docker:lint Runs the linter for the frontend and backend in docker containers
yarn deps Install dependencies for the frontend and backend
yarn start Starts the backend and frontend
yarn server Starts the backend
yarn client Start the frontend
yarn test Run tests for only the backend
yarn test:ci Run tests for the backend with coverage and output results to xml files
yarn test:all Run yarn test:ci for both the frontend and backend
yarn lint Run the linter only for the backend
yarn lint:ci Run the linter for the the backend with results output to xml files
yarn lint:all Run yarn lint:ci for both the frontend and backend

Deployment

Deployment to Staging and Production environments is automated through the CI/CD pipeline.

  • The main branch deploys to Staging.
  • The production branch deploys to Production

About

OHS TTA Project via ACF; Lead POC: Patrice Pascual and Ryan Ahearn

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 53.5%
  • HTML 38.0%
  • CSS 8.1%
  • Dockerfile 0.4%