The Assets package contains static assets such as fonts, images, and SVG icons for use by VA mobile applications.
The Assets package is a peer dependency to the Components package so it is expected to be added separately via your package manager (e.g. yarn) alongside using components. It does not contain any code, so it is up to the consumer to configure the package to be leveraged by their app, notably the fonts so they are available within your app for the components.
The components package contains an Icon convenience component that makes leveraging both the assets package icons and custom SVGs specific to your app easy; it is highly recommended to use for icon needs. A visual list of available icons can be found in Storybook.
Before contributing, consider if the contribution is necessary. This package is intended for shared assets. If your asset is only relevant to a specific app, then it should be handled within the app.
For fonts and images, contributing is as simple as adding the asset to the package via the GitHub web interface using the add file/folder buttons and creating a PR.
The majority of the included icons originate from a sprite sheet from @department-of-veterans-affairs/component-library. We have a script which extracts each of the SVGs from the sprite and saves them to the icons/vads
folder. This makes them easier to use with the aforementioned Icon component.
For icons intended for use across VA web and mobile, please consult with VADS as they must be approved by the Design System Council before they can be added to the source sprite. Keep in mind the Icon convenience component can handle custom SVGs to help display an app-specific icon without it being part of the assets package.