Biological & Chemical Oceanography Data Management Office

BCO-DMO Component Library

This resource will provide a visual standard and documentation for the BCO-DMO website UI.

Figma Designs Sitemap Personas Journey Maps HTML Site

Getting Started

Bulma + Nunjucks + Gulp (on Github)

This BCO-DMO website template uses the lightweight, open source CSS framework Bulma for mobile-tested, accessible UI base components, combined with Nunjucks for JS templating.

  • npm install - from inside bco-dmo project root the first time running the site locally to install all dependencies (ie. Gulp, Sass, etc.)
  • gulp auto - runs the site locally via localhost
  • src/ directory is where you make all content, template/layout, or component changes
  • dist/assets/* directories for images, CSS/Sass, and JS changes

Color

Primary
Primary Light
Accent
Accent Medium
Accent Light
Dark Gray
Gray
Light Gray
Lightest Gray

Typography

Also reference Bulma's Title and Subtitle headings elements for more variations.


Font Family: 'Lato' (Google Font)


Title Header 1

Title Header 2

Title Header 3 (default size)

Title Header 4

Title Header 5

Subtitle 1

Subtitle 2

Subtitle 3

Subtitle 4

Subtitle 5 (default size)

Primary Title Header 1


Body text size, 15px

Text link


Typography / Alignment Helpers

.has-text-centered Makes the text centered

.has-text-justified Makes the text justified

.has-text-left Makes the text aligned to the left

.has-text-right Makes the text aligned to the right


.is-capitalized Transforms the first character of each word to uppercase

.is-lowercase Transforms all characters to lowercase

.is-uppercase Transforms all characters to uppercase

.is-italic Transforms all characters to italic

Margin/Padding Helper Classes

These classes can be used to override or accompany built in styling where needed to properly space out an element or components. For example, this paragraph tag of text has .margin-bot-3 to give some subtle, consistent spacing beneath it.

Top Margin Bottom Margin Left Margin Right Margin

.margin-top-0

.margin-top-1

.margin-top-3

.margin-top-5

.margin-bot-0

.margin-bot-1

.margin-bot-3

.margin-bot-5

.margin-left-0

.margin-left-1

.margin-left-3

.margin-left-5

.margin-right-0

.margin-right-1

.margin-right-3

.margin-right-5

Top Padding Bottom Padding Left Padding Right Padding

.padding-top-0

.padding-top-1

.padding-top-3

.padding-top-5

.padding-bot-0

.padding-bot-1

.padding-bot-3

.padding-bot-5

.padding-left-0

.padding-left-1

.padding-left-3

.padding-left-5

.padding-right-0

.padding-right-1

.padding-right-3

.padding-right-5

Layout

For complete documentation, reference the Bulma Layout Docs.

Container

The .container element is used to create a consistent wrapper around content

Grid

If you need to horizontally divide content within a .container or any other section, you'll want to do so using columns. They will grow/shrink in size the more you add, and they are responsive and will collapse at specific breakpoints.

.column
.column
.column

In addition to standard .column class, you can add specific widths based on a 12 column grid, or use a combination of the two like below.

.is-full
.is-four-fifths
.column
.column
.is-three-quarters
.column
.column
.is-two-thirds
.column
.column
.is-three-fifths
.column
.column
.is-half
.column
.column
.is-two-fifths
.column
.column
.is-one-third
.column
.column
.is-one-quarter
.column
.column
.is-one-fifth
.column
.column

Hero

The hero is used as the top section of a page, often called a header or splash. There are many variations, check them out on Bulma Hero Docs.

Default Size Hero

Default Size Hero Subtitle

Primary and Centered Hero

Subtitle text would go here...

Image and Medium Size Hero

Subtitle text would go here...


Split Hero

This is a custom landing page hero meant to only be used on the home page for now. For it to display properly it needs to be a full width component, so the component library's narrow container will cause it to scrunch.

We are BCO-DMO

A repository funded by the National Science Foundation (NSF), supporting the oceanographic research community's data needs throughout the entire data life cycle.

Showcase Columns

Heading Text Size 4

Helper paragraph text would go here, keep it short and sweet.

Learn More

Header Text Size 4

Helper paragraph text would go here, keep it short and sweet.

Learn More

Header Text Size 4

Helper paragraph text would go here, keep it short and sweet.

Learn More

Buttons

The button is a versatile and essential element of the website. Check out Bulma Button Docs for more.

Anchor

Colors (Bulma Docs)


Sizes


Styles


Groups & Icon Add-ons


Grid Buttons

Tags

Tags are very versatile and a great way to display important information quickly and call attention to it when necessary. Check out all variations in Bulma Tags Docs.

Default Tag Primary Success Light Warning Light Danger Light
Default Icon Left Danger Icon Left Success Icon Right
Medium Size Large Size
Version 1.0

Alerts & Notifications

Alerts, referred to as Notifications in Bulma, are a way to grab the user's attention with important information.

Lorem ipsum dolor sit amet, consectetur adipiscing elit lorem ipsum dolor.
Lorem ipsum dolor sit amet, consectetur adipiscing elit lorem ipsum dolor.
Lorem ipsum dolor sit amet, consectetur adipiscing elit lorem ipsum dolor.
Lorem ipsum dolor sit amet, consectetur adipiscing elit lorem ipsum dolor.
Lorem ipsum dolor sit amet, consectetur adipiscing elit lorem ipsum dolor.

Form Elements

Form elements includes textboxes, select/dropdowns, checkboxes, radios, and any other custom form elements used in the BCO-DMO website. Check out the Bulma Form Docs for even more detail.

This username is available


Custom Search Elements



Cards

Placeholder image

Default Card Title

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus nec iaculis mauris.
Placeholder image

BCO-DMO

@bcodmo

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus nec iaculis mauris. @nsf. #hashtag

Search Results Card

Table

For more documentation, check out Bulma's Table Docs

Ver. Table Header Another Table Header
1.0 Lorem Ipsum Dolor Sit
2.0 Selected Row Link Selected Row
3.0 Phasellus Nec Iaculis Mauris