United States Department of State TalentMAP
A comprehensive research, bidding, and matching system to match Foreign Service employees with the right skills to available posts and positions.
Getting Started
Dependencies
We use yarn as our package manager, available for download here. Where possible, we've included the corresponding commands for npm.
Install dependencies with yarn install or npm i
EditorConfig
We use EditorConfig to ensure consistency across file formats and code editing environments. EditorConfig supports a variety of popular code editors listed here.
Running the App
TalentMAP API
You will need the State TalentMAP API running locally in order for this application to make requests to the API.
React Application
yarn start or npm start
Runs the app in development mode. Open http://localhost:3000 to view it in the browser.
The page will reload if you make edits. You will see the build errors and lint warnings in the console.
yarn test or npm test
Runs the test watcher in an interactive mode.
By default, runs tests related to files changed since the last commit.
yarn build or npm run build
Builds the app for production to the build folder. It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes. By default, it also includes a service worker so that your app loads from local cache on future visits.
Your app is ready to be deployed.
See the create-react-app documentation for more details.
Docker
The front end application is Dockerized and available in a docker-compose stack with the API. Setup and more available here.
Deploying
There is a brief deployment guide here that discusses deployment up the front end application. For more thorough intructions, including the API, checkout out the wiki.
Accessibility
Accessibility tests can be run in a CI environment using pa11y-ci. By default, it tests the URL array found in .pa11yci using the WCAG 2.0 AA standard. Be sure to update the array of URLs with IDs that exist in your environment's database.
Contributing
See CONTRIBUTING for additional information.
Public domain
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
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.