Welcome to your Design System

How to use this resource

This design system style guide is a shared resource for all who work on the website. It is a reference point for designers and developers on approved brand colors and type styles. It can also be useful to content editors to see what larger blocks are available for page building.

Global Elements

The "Foundations" section outlines the color tokens, typography styles, grids, and spacing rules used throughout the design system.

All Colors

Report issue

Every colors available on the site.

Defined in tokens/src/color.tokens.json.

Colorways

Report issue

Colorways are color relationships between background colors, text, buttons and other elements. Using a block with a different colorway can help break up a longer page or change the tone. The styles within a colorway adapt automatically to the background color by redefining the color values based on the colorway class.

Development notes: Defined in css/_elements/colorways.css

Blue 500 Colorway

Text colors:

Use as classes or CSS variables.

  • - color-primary

  • - color-secondary

  • - color-action

Inline text link style:

text-link

Buttons:

Input fields:

Error Message on

Yellow 500 Colorway

Text colors:

Use as classes or CSS variables.

  • - color-primary

  • - color-secondary

  • - color-action

Inline text link style:

text-link

Buttons:

Input fields:

Error Message on

White Colorway

Text colors:

Use as classes or CSS variables.

  • - color-primary

  • - color-secondary

  • - color-action

Inline text link style:

text-link

Buttons:

Input fields:

Error Message on

Green 500 Colorway

Text colors:

Use as classes or CSS variables.

  • - color-primary

  • - color-secondary

  • - color-action

Inline text link style:

text-link

Buttons:

Input fields:

Error Message on

Typography

Report issue

Use headings to improve scannability and provide context for users to better understand the page. Headings also help structure page content for screen readers and search engines. Headings should be logically structured on a page using proper hierarchy, headings are ranked 'h1' through 'h6.' A page starts with the H1 heading, which describes a page's main topic— the title of the page. Subsections can be organized with 'h2' level headings. Those subsections can themselves be divided with 'h3' level headings, and so on.

Development notes: Defined in tokens/src/typography.tokens.json.

Header styles

Report issue

.h1

The quick brown fox jumped over the lazy dog.

.h2

The quick brown fox jumped over the lazy dog.

.h3

The quick brown fox jumped over the lazy dog.

.h3-regular

The quick brown fox jumped over the lazy dog.

.h4

The quick brown fox jumped over the lazy dog.

.h5

The quick brown fox jumped over the lazy dog.

.h6

The quick brown fox jumped over the lazy dog.


Text styles

Report issue

.body-xl

The quick brown fox jumped over the lazy dog.

.body-lg

The quick brown fox jumped over the lazy dog.

.body-md

The quick brown fox jumped over the lazy dog.

.body-md font-medium

The quick brown fox jumped over the lazy dog.

.body-base

The quick brown fox jumped over the lazy dog.

.body-base font-medium

The quick brown fox jumped over the lazy dog.

.body-sm

The quick brown fox jumped over the lazy dog.

.body-xs

The quick brown fox jumped over the lazy dog.

.utility-lg

The quick brown fox jumped over the lazy dog.

.utility-md font-bold

The quick brown fox jumped over the lazy dog.

.utility-md

The quick brown fox jumped over the lazy dog.

.utility-base font-bold

The quick brown fox jumped over the lazy dog.

.utility-base

The quick brown fox jumped over the lazy dog.

.utility-sm font-bold

The quick brown fox jumped over the lazy dog.

.utility-sm

The quick brown fox jumped over the lazy dog.

.utility-xs

The quick brown fox jumped over the lazy dog.

.blockquote

The quick brown fox jumped over the lazy dog.

.tag

The quick brown fox jumped over the lazy dog.


Spacing values define the space between elements on the page. This can include space between buttons, between columns of text, or around an image. Setting a scale of sizes helps the page to feel cohesive and considered.

Development notes: Defined in tokens/src/spacer.tokens.json, and tokens/tailwind-site-spacing .json. .ts-py-block, .ts-my-block, .ts-py-block-sm and .ts-my-block-sm classes are available for consistent block-level spacing. All margin, padding and height classes use generated from these base values using Tailwind syntax. They are also available as CSS variables in this format "var(--spacer-[value]".

30

7.5 rem

(120 px)

24

6 rem

(96 px)

18

4.5 rem

(72 px)

16

4 rem

(64 px)

12

3 rem

(48 px)

10

2.5 rem

(40 px)

9

2.25 rem

(36 px)

8

2 rem

(32 px)

6

1.5 rem

(24 px)

4

1 rem

(16 px)

3

.75 rem

(12 px)

2

.5 rem

(8 px)

1

.25 rem

(4 px)

05

.125 rem

(2 px)


Grids used throughout the design system.

Developer notes: Defined in tokens/tailwind-grids.json. Use "xl:container p-site" for site container and padding classes. Grids can be applied as classes directly or with the apply syntax "@apply ts-grid-col-2"

ts-grid-col-1

ts-grid-col-2

ts-grid-col-3

ts-grid-col-4

ts-grid-4-8

ts-grid-7-5

ts-grid-8-4

ts-grid-9-3

ts-grid-center

Atoms & molecules

The “Atoms & Molecules” section outlines larger UI elements throughout the design system including buttons, inputs, dropdowns, and cards that display a variety of content. These elements are present within the larger blocks or sections of your page builder.


Inputs are used to collect information from users. They can be used to collect text, numbers, dates, or files. Inputs can be used in forms, search bars, or to filter content.

Development notes: Defined in tokens/src/inputs.tokens.json.

Searchable Select

views/atoms/input--select.twig

Select

views/atoms/input--select.twig

Card Listing

Report issue

molecules/card-listing

Placeholder image

Article

Blog Post Title Goes Here Lorem Ipsum dolor sit amet, consectetur adipiscing

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

Optional small text

molecules/card-lg

Placeholder image

Article

Blog Post Title Goes Here Lorem Ipsum dolor sit amet, consectetur adipiscing

By John Smith on September 24, 2023
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

molecules/card-sm

405+ statistical data point

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

Card News

Report issue

molecules/card-news

News card heading

An optional subheading

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vel viverra nisi, eget.

Card Numbers

Report issue

molecules/card-numbers

400+

The number card

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vel viverra nisi, eget.

Card Person

Report issue

molecules/card-person

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

Card Wayfinding Small

Report issue

molecules/card-wayfinding-small

Wayfinding Title

Wayfinding Title

Card Wayfinding

Report issue

molecules/card-wayfinding

Placeholder image

Wayfinding Title

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.
Placeholder image

Wayfinding Title

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.
Placeholder image

Wayfinding Title

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

molecules/filters

Section Title

Report issue

molecules/section-title

CTA Section Headline Goes Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat,
ipsum ac auctor ornare, nunc ligula scelerisque eros.

Blocks (global)

Blocks available on all pages. They can be used to build entire page layouts in dynamic ways.

List: unordered

Report issue

organisms/gb-blocks/wp-block-list-ul

  • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
  • Lorem ipsum dolor sit.
    • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
    • Lorem ipsum dolor sit.
    • Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
  • Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.

List: ordered

Report issue

organisms/gb-blocks/wp-block-list-ol

  1. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
  2. Lorem ipsum dolor sit.
    1. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
    2. Lorem ipsum dolor sit.
    3. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.
  3. Proin posuere erat sed est dignissim auctor. Curabitur tristique molestie nisi eu dignissim.

Pull Quote

Report issue

organisms/gb-blocks/wp-block-pullquote

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur sed sem sodales, imperdiet nunc sed, vestibulum ligula. Nam in urna est. Integer sagittis rhoncus turpis, in sodales nisl ultrices in. Duis sit amet malesuada nisi.

Jane Smith

organisms/gb-blocks/wp-block-table

Column #1 Column #2 Column #3
Lorem ipsum dolor Lorem ipsum dolor Lorem ipsum dolor
Lorem ipsum dolor Lorem ipsum dolor Lorem ipsum dolor
Lorem ipsum dolor Lorem ipsum dolor Lorem ipsum dolor

Accordion

Report issue

organisms/blocks/accordion

FAQ

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Call to Action

Report issue

organisms/blocks/cta

Blue Call to Action

CTA Headline Goes Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Yellow Call to Action

CTA Headline Goes Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

White Call to Action

CTA Headline Goes Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Call to Action with Outline

CTA Headline Goes Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Callout Card

Report issue

organisms/blocks/callout-card

Placeholder image

James Baldwin, French, 1948

James Baldwin’s first experience living abroad was in Paris, France, where he relocated in 1948, in the hopes that a new place and time away would help him finish his first novel, Go Tell It On The Mountain (1953) and draft his famous collection of essays, Notes of a Native Son (1955).

Cards: Info

Report issue

organisms/blocks/cards-info

About the Summer Abroad Program

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

405+ statistical data point

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placera ipsum ac auctor ornare, nunc ligula scelerisque eros.

1300 is a nifty number.

It's represents something meaningful.

Lorem ipsum headline goes here.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placera ipsum ac auctor ornare, nunc ligula scelerisque eros.

Lorem ipsum

Lorem ipsum dolor sit amet.

White Colorway, 3 cards

About the Summer Abroad Program

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

405+ statistical data point

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placera ipsum ac auctor ornare, nunc ligula scelerisque eros.

1300 is a nifty number.

It's represents something meaningful.

Lorem ipsum headline goes here.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placera ipsum ac auctor ornare, nunc ligula scelerisque eros.

Cards: People

Report issue

organisms/blocks/cards-people

People Cards

A block that displays a set of cards with links.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

People Cards: blue option

A block that displays a set of cards with links.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

John S.

Turkish, Academic year 2023

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros. Lorem ipsum dolor sit amet.

Cards: Small Wayfinding

Report issue

organisms/blocks/cards-wayfinding-small

Wayfinding Cards Small

Card title one

Card title two

Card title three

Card title four

Card title five

Card title six

Wayfinding Cards Small: White

Card title one

Card title two

Card title three

Card title four

Card title five

Card title six

Cards: Wayfinding

Report issue

organisms/blocks/cards-wayfinding

Wayfinding Cards

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Card title one

Card text

Card title two

Card text

Card title three

Card text

Wayfinding Cards: Yellow

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Card title one

Card text

Card title two

Card text

Card title three

Card text

Wayfinding Cards: White

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec placerat, ipsum ac auctor ornare, nunc ligula scelerisque eros.

Card title one

Card text

Card title two

Card text

Card title three

Card text

Hero: Full Bleed

Report issue

organisms/blocks/hero-full-bleed

White colorway: without image, eyebrow and breadcrumbs

Apply now

Interested applicants, families, and educators can register to receive updates about the NSLI-Y application by submitting a name and email address into the “Receive NSLI-Y Application Updates!” section on the right-hand panel of this page.

There is a single application for three U.S. Department of State programs: NSLI-Y, Future Leaders Exchange (FLEX) Abroad, and Kennedy-Lugar Youth Exchange and Study (YES) Abroad. Applicants interested in applying for more than one of these programs now only need to prepare one application. In this common application, applicants will indicate which programs they wish to apply for. Applicants may apply and potentially be selected for more than one program but will only be able to accept one scholarship award. Learn more about the three programs here.

White colorway: with all fields

Lorem Ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

Placeholder image

Blue 500 colorway: with all fields

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

Placeholder image

Blue 500 colorway. Without image, breadcrumbs and eyebrow

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

Hero: Simple

Report issue

organisms/blocks/hero-simple

White colorway: without image, eyebrow and breadcrumbs

Apply now

Interested applicants, families, and educators can register to receive updates about the NSLI-Y application by submitting a name and email address into the “Receive NSLI-Y Application Updates!” section on the right-hand panel of this page.

There is a single application for three U.S. Department of State programs: NSLI-Y, Future Leaders Exchange (FLEX) Abroad, and Kennedy-Lugar Youth Exchange and Study (YES) Abroad. Applicants interested in applying for more than one of these programs now only need to prepare one application. In this common application, applicants will indicate which programs they wish to apply for. Applicants may apply and potentially be selected for more than one program but will only be able to accept one scholarship award. Learn more about the three programs here.

White colorway: with all fields

Subheading goes here

Lorem Ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

Placeholder image

Blue 500 colorway: with all fields

Subheading goes here

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

March 15, 2024
Placeholder image

Blue 500 colorway. Without image, breadcrumbs and eyebrow

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.

Image & Text

Report issue

organisms/blocks/image-text

Placeholder image

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.
Optional attribution
Placeholder image

Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras justo odio, dapibus ac facilisis in, egestas eget quam.
Optional attribution