This site uses Jekyll, a Ruby-based static site generator and is built with the U.S. Web Design System v 2.0, a set of reusable, high-quality components for modern websites. Additionally, this site is optimized for deployment on 18F's Federalist publishing service.
$ git clone https://github.com/usdoj-crt/beta-ada
$ cd beta-ada
This site requires Ruby and Node.js in order to run locally. For guidance on installing the project's requirements, please see the Local development environment wiki page.
$ npm install
$ bundle install
$ npm start
OR
$ bundle exec jekyll serve
To build but not serve the site, run npm run build or bundle exec jekyll build.
$ docker-compose run node npm install
$ docker-compose build
$ docker-compose up
To build but not serve the site, run:
docker-compose run ruby bundle exec jekyll build
Note that when built by Federalist, npm run federalist is used instead of
npm run build.
Open your web browser to localhost:4000 to view your site.
UI & Snapshot testing is accomplished using Playwright.
UI Tests confirm that individual features of the interface perform as expected, while Snapshot testing looks for changes in each page from a previous, stored version and flags any changes.
Currently testing is only available on development branches, though the plan is to eventually add Snapshot testing to our Github Actions suite.
To run:
In the root directory of the beta-ada/ project folder, run the following command:
npm init playwright@latest
A series of prompts will appear after that, these will help initialize your project.
Follow these steps to correctly initialize your project. Note you only need to initialize the project once.
- Do you want to use TypeScript or JavaScript?
- JavaScript
- Where to put your end-to-end tests?
- tests
- Add a Github Actions workflow?
- n
-
Playwright will then download playwright versions of the chromium, webkit and firefox browsers.
-
A
playwright.config.jsfile already exists, DO NOT OVERRIDE IT.
- n
You are now initialized! Also, it's assumed that you've run npm install by now, but if you haven't already, go ahead and do that to install Playwright.
$ npm run test:ui
$ docker-compose run node npm run test:ui
- Jekyll - The primary site engine that builds your code and content.
- Front Matter - The top of each page/post includes keywords within
--tags. This is meta data that helps Jekyll build the site, but you can also use it to pass custom variables. - U.S. Web Design System v 2.0
See CONTRIBUTING for additional information.
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.