Prototyping

Figma

Using Figma and the HTML to Figma Plugin is recommended for creating static prototypes using a pattern library created with the Patterns Framework.

It will allow you to import styled HTML from a pattern’s static site to retrieve basic elements such as colors, layouts, etc. The HTML to Figma app will not be able to include fonts and svgs and may have trouble with the styling of background, psuedo elements, and elements hidden on the screen.

Pattern library assets including fonts, SVGs, and images can be downloaded. Click here to download a copy of v0.16.1.zip. Assets for can be found in the following directories;

Fonts; /dist/fonts
SVGs (icons); /dist/svg
Images; /dist/images

Browser

Using the CDN method of the installation is recommended for building prototypes in the browser. Import the pattern library’s global stylesheet and scripts via the CDN into any web page.

Compiled styles and scripts in the /dist folder of the GitHub repository can be imported on the page using a CDN such as JsDelivr. The following global stylesheet link can be copied and pasted into the the <head> of your html document.

<link href="https://cdn.jsdelivr.net/gh/cityofnewyork/access-nyc-patterns@v0.16.1/dist/styles/site-default.css" rel="stylesheet">

The following global script source can copied and pasted before the closing </body> tag of your html document.

<script src="https://cdn.jsdelivr.net/gh/cityofnewyork/access-nyc-patterns@v0.16.1/dist/scripts/access-nyc.js"></script>

The following url is the base url for all distributed files available via a CDN.

https://cdn.jsdelivr.net/gh/cityofnewyork/access-nyc-patterns@v0.16.1/dist/

Visit the GitHub repository to browse all available files. All Patterns are distributed with their own styles and script dependencies in the /dist folder. For example, all of the “Accordion” dependencies would live in the /dist/components/accordion folder.

Components scripts must be initialized individually.

<script type="text/javascript">
  var patterns = new AccessNyc(); // initialize the global script

  patterns.accordion(); // initialize an individual component
</script>

Each pattern’s initialization is documented on it’s dedicated page.