Browse Foundations

Foundations

Overview

Borders define structure and separation across SGDS components. Tokens cover width and corner radius.

Principles

Clarity

Use borders to show structure and support readability.

Subtlety

Keep borders minimal so content stays the focus.

Separation

Use border width to separate content and clarify where areas begin and end.

Characteristics (width)

Default - 1 px

The default border width is used to illustrate the boundary of components and divide content.

Label
Placeholder text

Medium - 2 px

Medium borders are used to emphasise elements that primarily use borders for hover interaction, like input field.

Label
Placeholder text

Strong - 4 px

Strong borders are used to emphasise elements that primarily use borders for their structure, like tabs.

Characteristics (radius)

None and minimal (0 px, 2 px)

Used for sharp, structured designs with little to no rounding. Suitable for strict, grid-based layouts where clarity and precision are key.

  • Data tables (0 px for a rigid, structured look)
  • Dividers or separators (2 px for subtle softness)
HeaderHeaderDataDataDataData

Compact (4 px)

Provides slight rounding for a modern but understated look. Enhances usability while keeping a clean and structured appearance.

  • Icon button 24 px and 32 px
  • Tags, pills, or badges
Badge label

Standard (8 px)

The default radius for most components, balancing smoothness and sharpness. Works well across both functional and decorative elements.

  • Cards and modals
  • Tooltips and dropdowns
  • Inputs
Label
Placeholder text
Button label

Expressive (12 px, 16 px, 24 px)

Larger radius sizes that create a more distinct and friendly visual style. Used to emphasise key components and create a softer, more inviting look.

  • Modal and large callout banners (12 px, 16 px)
  • Feature cards or promotional sections (24 px)
Modal title
Modal description
Callout banner — a long-form informational message for users. Feature card Promotional sections use the largest expressive radius for a softer, friendlier look.

Fully rounded (full)

Used for completely rounded shapes, ensuring a pill-like or circular appearance. Best for elements that need to stand out or convey a tactile feel.

  • Avatars and profile images
  • Floating action buttons (FABs)
AB
Avatar
Avatar
FAB

Singapore Government Design System

The Singapore Government Design System was developed to empower teams in creating fast, accessible and mobile-friendly digital services.

Past VersionsSGDS v1SGDS v2