nasawds
v4.0.67
Published
The same [USWDS](https://designsystem.digital.gov/) you know and love, with NASA theming!
Downloads
2,274
Readme
NASA Web Design System
The same USWDS you know and love, with NASA theming!
NASA Theme customizations
- Minor tweaks to colors in
_uswds-theme-color.scss
- Headings use helvetica instead of source sans pro font in
_uswds-theme-typography.scss
- NASA meatball favicons in
theme/favicons
- Dark header option and other minor visual tweaks in
_uswds-theme-custom-styles.scss
- See it live!
- To use the dark header option, add the
.usa-header--dark
class to the<header>
element. - For the close icon in the mobile slideout menu to appear white instead of dark gray replace
close.svg
withclose-white.svg
in this line of html<button class="usa-nav__close"><img src="/assets/img/close.svg" alt="close"></button>
How to Use
Like USWDS, NASAWDS has two installation options:
Direct download - Download the .zip file attached to the latest stable release under the assets section. Extract then add the files to your project's code base. For more details see this section in the USWDS developer documentation.
Install using npm - NASAWDS is available as an npm package. To install via npm, follow these instructions, but where it says
uswds
replace withnasawds
. Once installed, you will find the compiled asset files in thenode_modules/nasawds/src/
directory.
For more detailed installation and usage instructions see the USWDS developer documentation.
Creating a webpage using NASAWDS
- Create an index.html file at the top of your repository
- Paste into that file
<html>
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title>My Example Project</title>
<link rel="stylesheet" href="./assets/css/styles.css" />
</head>
<bod>
<script src="assets/js/uswds.min.js"></script>
</body>
</html>
- Go to this USWDS page of page templates, find a page template you like, click the 'COMPONENT CODE' button, and copy the HTML code out of the window and into your index.html file between the
<body>
tags. - Note that the page templates are form an earlier version of USWDS so the relative links to the CSS, JS, and Img files need to be changed. If you used NPM to get the NASAWDS files, you'll want to do a replace all on the index.html file you currently have such that all
assets/
are replaced withnode_modules/nasawds/src/
. - You should now have a nice looking index.html page to start editing from.
Updates
NASAWDS now updates to the latest version of USWDS automagically. (thanks GitHub Actions!)
NASAWDS uses a GitHub Action workflow to check for an updated version of USWDS every 15 days and updates itself automatically with the latest version on the develop branch, and releases a beta pre-release on GitHub and NPM. A two week window is provided for testing. Any issues found should be opened in this repository. After two weeks, if no unresolved issues are present in this GitHub repository, a GitHub Action workflow creates a new stable release on GitHub and NPM and merges develop into master.