This is the pattern library for the City of Boston. It's currently a work in progress, but we're adding to it every day.
This project contains the marks and trade dress of the City of Boston's digital properties and should not be reused without the express permission of the City of Boston.
We recommend using yarn. Run yarn to install dependencies.
Once the repository has been cloned, you can build the components with:
yarn gulp build
After building the components, you can run yarn fractal -- start --watch to get a server running. You should be able to visit http://localhost:3000 in your browser and view the pattern library.
The pattern library is built using Stylus. We're using PostCSS, Autoprefixer, and Rucksack as well. When Javascript is required, we're using plain javascript. All components should work without javascript as a default.
To develop against the pattern library, you can run:
yarn gulp
This will build the components and watch for changes. Run yarn fractal -- start --watch in another window to keep a server running.
If you need to submit a bug report for the pattern library, please follow these guidelines. Following these guidelines helps us and the community better understand your report, reproduce the bug, and find related issues.
- Verify that you are able to reproduce it repeatedly. Try multiple browsers, devices, etc. Also, try clearing your cache.
- Perform a quick search of our existing issues to see if it has been logged previously.
- Use a clear and descriptive title when creating your issue.
- Include a bulleted list of steps to reproduce your issue.
- Include the URL of the page that you're seeing the issue on.
- Include screenshots if possible. Bonus points if you include an animated GIF of the issue.
- Include details about your browser (which one, what version, using ad blockers?).
- When filing your issue, assume that the recipient knows nothing about what you're talking about. There is no such thing as too many details when filing your issue.
## Basic details
URL: [URL]
## Steps to reproduce
1. [FIRST]
2. [SECOND]
3. [THIRD]
## What I think should happen
[Describe your expected behavior here]
## What did happen
[Describe the actual behavior here]
## Browser details
Browser: [Enter browser]
Version: [Enter version]
Ad blocker: [Ad blocker?]
[SCREENSHOT]
This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected].