Routing

Last Updated: 27 Aug 2024

Intro

This documents gives details about the reverse proxy config and React Router.

Reverse Proxy Config

The reverse proxy handles incoming URL requests to VA.gov and is managed through a reverse proxy routing config file.

React Router

To use client side routing such as react-router, the react_routes section must be configured to ignore the route. For example, a React app running at www.va.gov/appPath would need this added:

CODE

  - path: /appPath
    protected: no

By default, one url path maps to one document. This configuration changes the default behavior so that any additional path parts after /appPath like /appPath/IntroductionPage will return the document at /appPath.

Server-side Redirects

To redirect from one URL to another, use the redirects section with a src, dest, and optional params such as:

CODE

  # Redirect /caregivers/introduction to /caregivers
  - src: /caregivers/introduction
    dest: /caregivers
    rewrite: permanent

  # Redirect various claim process and apply links
  - src: /disability-benefits/claims-process/ratings/
    dest: /disability-benefits/eligibility/ratings/

  # ==============
  # March 23, 2020: https://github.com/department-of-veterans-affairs/va.gov-team/issues/7104
  # ==============
  - src: ^/coronavirus-veteran-faq/?$
    dest: /coronavirus-veteran-frequently-asked-questions/
    matcher: "~*"

Help and feedback

Suggest content changes to this page.
Submit new Platform Website content.
Get help from the Platform Support Team in Slack.
Submit a feature idea to the Platform.