Style guide
- Global Elements
- All Colors
- Colorways
- Typography
- Spacing
- Grids
- Atoms & Molecules
- Buttons & Links
- Inputs
- Breadcrumbs
- Card Listing
- Card LG
- Card SM
- Card News
- Card Numbers
- Card Person
- Card Wayfinding Small
- Card Wayfinding
- Filters
- Section Title
- Blocks (general)
- Gallery
- List: unordered
- List: ordered
- Pull Quote
- Table
- Blocks (custom)
- Accordion
- Call to Action
- Callout Card
- Cards: Info
- Cards: People
- Cards: Small Wayfinding
- Cards: Wayfinding
- Hero: Full Bleed
- Hero: Simple
- Image & Text
- Social Links
- Footer
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 issueEvery colors available on the site.
Defined in tokens/src/color.tokens.json.
Colorways
Report issueColorways 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-linkButtons:
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-linkButtons:
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-linkButtons:
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-linkButtons:
Input fields:
Error Message on
Typography
Report issueUse 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
Report issueSpacing 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
Report issueGrids 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.
Buttons & Links
Report issueButton styles are dynamic. They can be modified by adjusting the size, icon, and icon placement properties. Icons shown are examples. Any icon can be used. Button colors will adjust automatically based on the background color.
Development notes: Defined in tokens/src/buttons.tokens.json. Button colorways are defined in css/_elements/colorways.css. To add an svg icon, place the svg code in assets/images/svgs, and pass the svg file name as the 'svg_name' property when you include the button component in your template. You can also use Tailwind @apply syntax to apply button classes directly (In CSS: @apply btn-solid;). Note that with @apply syntax, you can't add an icon.
Button Sizes
Report issueButtons come in three sizes: large, medium, and small.
Icon Options
Report issueShown are a button style with no icon, icon only, an icon before the text, an icon after the text, and in a disabled state.
White Colorway
How buttons display on different colorways
Report issueShown are a button style with no icon, icon only, an icon before the text, an icon after the text, and in a disabled state.
Inputs
Report issueInputs 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
Breadcrumbs
Report issuemolecules/breadcrumbs
Card Listing
Report issuemolecules/card-listing

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.
Card LG
Report issuemolecules/card-lg

Article
Blog Post Title Goes Here Lorem Ipsum dolor sit amet, consectetur adipiscing
Card SM
Report issuemolecules/card-sm
405+ statistical data point
Card News
Report issuemolecules/card-news
News card heading
An optional subheading
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vel viverra nisi, eget.
Card Numbers
Report issuemolecules/card-numbers
400+
The number card
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vel viverra nisi, eget.
Card Person
Report issuemolecules/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 issuemolecules/card-wayfinding-small
Card Wayfinding
Report issuemolecules/card-wayfinding

Wayfinding Title

Wayfinding Title
Filters
Report issuemolecules/filters
Section Title
Report issuemolecules/section-title
CTA Section Headline Goes Here
Blocks (global)
Blocks available on all pages. They can be used to build entire page layouts in dynamic ways.
Gallery
Report issueorganisms/gb-blocks/wp-block-gallery









List: unordered
Report issueorganisms/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 issueorganisms/gb-blocks/wp-block-list-ol
- 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.
Pull Quote
Report issueorganisms/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
Table
Report issueorganisms/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 issueorganisms/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 issueorganisms/blocks/cta
Blue Call to Action
CTA Headline Goes Here
Yellow Call to Action
CTA Headline Goes Here
White Call to Action
CTA Headline Goes Here
Call to Action with Outline
CTA Headline Goes Here
Callout Card
Report issueorganisms/blocks/callout-card

James Baldwin, French, 1948
Cards: Info
Report issueorganisms/blocks/cards-info
About the Summer Abroad Program
405+ statistical data point
1300 is a nifty number.
Lorem ipsum headline goes here.
Lorem ipsum
White Colorway, 3 cards
About the Summer Abroad Program
405+ statistical data point
1300 is a nifty number.
Lorem ipsum headline goes here.
Cards: People
Report issueorganisms/blocks/cards-people
People Cards
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
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 issueorganisms/blocks/cards-wayfinding-small
Cards: Wayfinding
Report issueorganisms/blocks/cards-wayfinding
Wayfinding Cards
Card title one
Card title two
Card title three
Wayfinding Cards: Yellow
Card title one
Card title two
Card title three
Wayfinding Cards: White
Card title one
Card title two
Card title three
Hero: Full Bleed
Report issueorganisms/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.

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.

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 issueorganisms/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.

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.

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 issueorganisms/blocks/image-text

Lorem ipsum dolor sit amet

Social Links
Report issueorganisms/blocks/social-links