Visual Style Guide

This style guide outlines the aesthetic elements & standards currently being used across MakerDAO's community initiatives. At the time of writing, an official MakerDAO style guide has not been published, but this one uses many of the existing colors, type scales, etc. present on the makerdao.com website.

Colors

Maker uses three highlight colors - Maker Teal, Maker Orange & Maker Blue, plus a color for Headings and one for Body Text.

CSS

Declare the colors as global CSS variables.

* {
—color-makerteal: #1aaa9b;
—color-makerorange: #f5b13d;
—color-makerblue: #08529b;
—color-headline: #291a42;
—color-body: #53546a;
}

Maker Teal

#1aaa9b

Our primary highlight color. This is darker than the "standard" Maker Teal color used on their website #30bd9f to improve contrast and legibility.

Usage

  • In-line text links

  • Headlines

  • Section Titles

  • Labels

Examples

Highlights the major statistics on the Maker Transparency Dashboard.

The :active color on the Pill object and Section Title in the Transparency Dashboard.

Maker Orange

#f5b13d

Our secondary highlight color. Can be paired with Maker Gradient Orange to create sections or elements on a page with complimentary hues.

Usage

  • Secondary highlights on a page that contrast against Maker Teal.

  • Provide visual contrast on the page

Examples

Applied to this doughnut chart on the Transparency Dashboard and its corresponding statistic (to the left).

Maker Blue

#08529b

Our tertiary highlight color. Used sparingly in coordination with Maker Gradient Blue to create sections on the page that stand apart - such as a call to action section to sign-up to something, or a footer.

Usage

  • Create contrast within specific elements on a page.

  • Headlines

  • Labels

Examples

Used in both the Section Title and Label for this section of the Maker Transparency Dashboard.

Headline Color

#291a42

A high contrast near-black with a subtle dark purple hue.

Usage

  • <h1> Headlines.

  • Section Title's

Examples

Used as the above-the-fold headline on the Maker Grants Transparency Dashboard

Body Color

#53546a

A softer mid-gray.

Usage

  • All body text

  • Any h2 or h3 headlines that you want to display with a softer contrast.

Examples

Used in both the label and description text within each RowCard.

Maker Gradient Primary

A versatile teal-to-yellow gradient used across Maker properties as a primary background for major sections or entire pages.

linear-gradient(180deg, rgba(182, 237, 231, 0.38) 0%, rgba(253, 193, 52, 0.15) 100%)

Usage

  • The background of a major <section> on your page or the <body>.

Examples

The Transparency Dashboard uses this as its main background across the entire page. You can limit it to a single section.

Gradient Green

Can be paired with Maker Teal to create elements or sections with a complimentary hue.

linear-gradient(hsla(168,50%,90%,1),hsla(168,50%,86%,1))

Usage

  • Paired with Maker Teal to highlight concise pieces of information.

  • May be used as a <Section> background.

  • May be used as a <Button> background.

Examples

Maker Grants Transparency Dashboard. Used to provide contrast/separation on one category of statistics

Gradient Orange

Used as a background that can pair with Maker Orange

linear-gradient(hsla(39,70%,91%,1),hsla(39,70%,86%,1))

Usage

  • A <Section> background

  • A <Button> background

Examples

Used for visual contrast to display a category of stats on the Maker Transparency Dashboard. In this case, Maker Teal is used for the number and Body Color for the descriptive text.

Gradient Blue

Paired with Maker Blue as a tertiary highlight. Used as a <section> background to establish a distinct contrast of content on the page.

linear-gradient(hsla(210,50%,90%,1),hsla(210,50%,86%,1))

Usage

  • A <Section> background

  • A <Button> background

Examples

Used as the background to a section in the Maker Transparency Dashboard

Typography

Maker's Community properties use a simple type scale: 3 headlines, a body, and a label.

h1 {
font-size: 2.25rem;
}
h2 {
font-size: 1.5rem;
}
h3 {
font-size: 1.25rem;
}
p {
1.125rem;
}
.label {
font-size: 1rem;
text-transform: uppercase;
}

Headline 1

Usage

Used sparingly for major statements on a landing page, such as the opening headline you find "above the fold"

Example

Used as the above-the-fold headline on the Maker Grants Transparency Dashboard

Headline 2

Usage

Used for all Section Titles on a page.

Examples

An example of a Section Title.

Another example of a Section Title.

Headline 3

Usage

  • Body text within RowCards

  • Subheadings

  • Give additional prominence to elements on a page (e.g. statistics)

Examples

In the Transparency Dashboard, it's used to highlight our grant program statistics.

Body

Usage

  • Used with <p> for paragraphs of text on a page.

Label

Usage

  • Define sections of content.

  • Incorporated into the Pill object

Examples

Used in as the "question" in a Q&A format within a LinkCard to link out to frequently asked questions.

Used to define the status of a project (in this case - "Beta") within a RowCard that details a project that has been supported by the Maker Community Grants program.

Typeface

Maker currently uses system fonts across its properties, with Helvetica Neue as a backup.

* {
font-family: system-ui, 'Helvetica Neue', sans-serif;
}

Objects

Buttons

Usage

  • Calls-to-action (e.g. verbs such as creating, confirming, canceling, viewing).

Examples

Button Primary For any primary calls-to-action, like creating an account or submitting a form.

Button Secondary For any secondary calls-to-action, like canceling out of a flow, or triggering an alternative display, etc.

.buttonPrimary {
display: flex;
justify-content: center;
align-content: center;
padding: 0.875rem 1.5rem 0.875rem 1.5rem;
color: #fafafa;
background: var(--color-makerteal);
font-size: 1.25rem;
border: 1px solid var(--color-makerteal);
border-radius: 2px;
outline: none;
opacity: 1;
font-size: 1.25rem;
transition: 0.2s ease-in-out;
};
.buttonPrimary:hover {
translate: transformY(-10%);
cursor: pointer;
};
.buttonSecondary {
display: flex;
justify-content: center;
align-content: center;
padding: 0.875rem 1.5rem 0.875rem 1.5rem;
color: var(--color-makerteal);
background: transparent;
font-size: 1.25rem;
border: 1px solid var(--color-makerteal);
border-radius: 2px;
outline: none;
opacity: 1;
font-size: 1.25rem;
transition: 0.2s ease-in-out;
}
.buttonPrimary:hover {
translate: transformY(-10%);
cursor: pointer;
};
<button class="buttonPrimary">A Primary Button</button>
<button class="buttonSecondary">A Secondary Button</button>

Pills

Used as a tab mechanism, to filter content within a specific section on a page.

Usage

  • As tabs, to filter content

  • A tertiary button style

Examples

Active

Inactive

Code

<button class="makerPill">
Pill
</button>
.makerPill {
min-width: 120px;
color: var(--maker-bodycolor);
padding: 0.5rem 0.875rem 0.5rem 0.875rem;
outline: none;
border-radius: 100px;
border: 1px solid var(--maker-bodycolor);
text-transform: uppercase;
font-weight: 400;
transition: 0.2s ease-in-out;
}
makerPill:hover {
border: 1px solid var(--maker-teal);
color: var(--maker-teal);
}

RowCards

We use RowCards to organize and structure content into lists. They break down from Rows into Cards at smaller viewports.

Usage

  • Lists that must display multiple types of information

Examples

We use the RowCards to create a list of Grantees in the Maker Transparency Dashboard.

A single RowCard

Multiple RowCards in a list This example is a list of Grantees displayed on the Maker Transparency Dashboard

A single RowCard @mobile breakpoint

Multiple RowCards in a list @mobile breakpoint

<div class="rowCardWrapper">
<div class="rowCardContainer">
<div class="rowCardTopContainer">
<a href="#" class="rowCardLink">
<h2 class="makerHeadline2">RowCard Title↗
</a>
<div class="rowCardContentSecondary">
Social Link Icons
</div>
</div>
<div class="rowCardDescription">A description or other relevant content.</div>
<div class="rowCardBottomContainer">
<p class="makerLabel">
LABELS
</p>
</div>
</div>
</div>
/* Wraps all the RowCard objects */
.rowCardWrapper {
grid-column: 1 / -1;
display: grid;
grid-template-columns: minmax(300px,1024px);
justify-items: center;
justify-content: space-around;
margin: 0rem 1rem 0rem 1rem;
}
/* The RowCard object */
.rowCardContainer {
display: flex;
width: 100%;
max-width: 1024px;
flex-direction: column;
align-items: flex-start;
justify-content: space-between;
background: hsl(210,33%,98%);
border: 1px solid hsla(240,10%,90%,1);
border-top: 0px;
padding: 1rem;
}
.rowCardContainer:first-child {
border-top: 1px solid hsla(240,10%,90%,1);
border-top-left-radius: 8px;
border-top-right-radius: 8px;
}
/* Contains the RowCard title and optional secondary content */
.rowCardContainerTop {
display: flex;
flex-direction: row;
width: 100%;
justify-content: space-between;
}
.rowCardLink {
transition: 0.2s ease-in-out;
}
.rowCardLink:hover {
color: var(--Maker-Teal);
}
.rowCardHeadline {
font-size: 1.5rem;
color: var(--Maker-Headline);
margin: 0;
text-overflow: ellipsis;
white-space: nowrap;
transition: 0.15s ease-in-out;
}
/* Contains the social icons in the example. Optional and can be removed if unnecessary for your use case */
.rowCardContentSecondary {
display: flex;
justify-items: center;
align-items: center;
}
/* Any secondary content. In the example this contains the project description, but it can be used for any relevant text-string. */
.rowCardContentSecondary {
color: var(--body-color);
width: 75%;
white-space: normal;
text-overflow: ellipsis;
max-height: 140px;
overflow: hidden;
padding: 1rem 1rem 1rem 0rem;
}
/* Contains any supporting content. In the example, we list out descriptive/category labels*/
.rowCardBottomContainer {
display: flex;
flex-direction: row;
flex-wrap: nowrap;
justify-content: space-between;
width: 100%;
}
/* Our standard label object */
.makerLabel {
font-size: 1rem;
margin: 0 1rem;
color: var(--body-color);
text-transform: uppercase;
text-align: left;
}
/* Mobile styles */
@media and (max-width: 420px) {
.rowCardWrapper {
grid-gap: 1rem;
}
.rowCardContainer {
max-width: 280px;
border-radius: 4px;
padding-bottom: 0;
}
.makerLabel {
padding: 1rem 0rem 1rem 0rem;
}
}

Section Titles

Uses Headline 3 with text-transform: uppercase. Color is dependent on the section background-color used.

Usage

  • Title / define specific sections on the site.

Examples

The title for the list of grantees in the Maker Grants Transparency Dashboard. The color is Maker Teal - ##1aaa9b

The title for a list of common questions that link out to their respective answers.

.sectionTitle {
text-transform: uppercase;
color: var(--color-makerteal) /* Use a color that's complimentary to the background */
}

Inline Links

Usage

Links to external sites for in-line text, e.g. within a paragraph of text.

a {
color: var(—color-makerteal)
transition: 0.15s ease-in-out;
}
a:hover {
border: 1px solid var(—color-makerteal)
}

Examples

An inline link.

The inline link on :hover

LinkCard

For links that require more prominence.

Usage

  • Linking out to FAQs

  • Displaying slightly larger amounts of contextual information than a single inline text link would.

Examples

LinkCard Active (on hover).

LinkCard Inactive.

Used in the Footer of the Transparency Dashboard to link out to external educational resources. It contains a Label object and Headline 3 object within a container.

/* Wraps all LinkCards */
.LinkCardWrapper {
display: grid;
grid-template-columns: minmax(320px,540px);
grid-gap: 2rem;
}
/* The parent container object for each LinkCard */
.LinkCardContainer {
color: var(--body-color);
padding: 1.5rem 1.875rem 1.875rem 3rem;
border-radius: 4px;
margin: 1rem 0rem;
background: none;
transition: 0.15s linear;
border: 1px solid hsla(209,51%,80%,1);
border-radius: 4px;
}
.LinkCardContainer:hover {
background: */ Whatever background-gradient is complimentary */
}
<ul class="LinkCardWrapper">
<a href="*">
<ul class="LinkCardContainer">
<li>
<h4 class="label">Label</h6>
</li>
<li>
<p class="body-text"> Text description</p>
</li>
</ul>
</a>
</ul>