sgds-getting-started

Configures fonts, CSS imports, component registration, and layout for new SGDS web component projects.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/HiokKuek/hdb_pricing --skill sgds-getting-started-hiokkuek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sgds-getting-started
Source: https://github.com/HiokKuek/hdb_pricing/tree/main/.agents/skills/sgds-getting-started
Command: npx skills add https://github.com/HiokKuek/hdb_pricing --skill sgds-getting-started-hiokkuek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @govtechsg/sgds-web-component.

What problem does it solve? Setting up a new project with the SGDS web component library involves several ordered steps—font loading, theme and foundation CSS imports, Tailwind-processed utility classes, and component registration—and doing them in the wrong order breaks styling or utility classes. This Skill provides the correct sequence so a new SGDS application renders correctly from the start. ## Core Features & Use Cases - Ordered four-step setup: Loads the Inter font in the HTML head, imports theme/foundation/utility CSS in the correct order, registers all <sgds-*> components with a single JS import, and wraps content in an SGDS app layout. - Layout templates: Provides ready-made markup for both Simple App (public-facing) and Sidebar App (dashboards/internal tools) layouts using .sgds-container and .sgds-container-sidebar. - Use Case: A developer bootstrapping a new Singapore government-style web app asks the AI to scaffold the project; the Skill ensures the Inter font link, themes/day.csssgds.cssutility.css import order, Tailwind v4 processing, and masthead/mainnav/footer shell are all in place before any page code is written. ## Quick Start Set up a new SGDS web component project with the correct font, CSS imports, component registration, and a simple app layout.

Frequently Asked Questions about sgds-getting-started

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new SGDS web component project?

Complete four steps in order: add the Inter font link to your HTML head, import themes/day.css then css/sgds.css then css/utility.css in your main CSS file, register components with a single import of @govtechsg/sgds-web-component, and wrap content in an SGDS app layout.

What CSS import order does SGDS require?

Import the theme file (themes/day.css, optionally night.css) first, then css/sgds.css for foundation styles, then css/utility.css for utility classes. The theme must come first so CSS variable tokens exist when foundation and utility styles are processed.

Why are my sgds: utility classes not working?

The css/utility.css file contains Tailwind v4 directives and must be imported inside a CSS file processed by your Tailwind pipeline. Importing it directly in JavaScript will not generate the sgds: prefixed utility classes.

Does SGDS support React, Vue, Angular, or Next.js?

Yes, the single import of @govtechsg/sgds-web-component registers all sgds custom elements globally, which works across frameworks. Framework-specific integration details are covered in the separate sgds-components skill.

Which SGDS layout should I use for my app?

Use the Simple App layout with .sgds-container for public-facing, general-purpose services. Use the Sidebar App layout with .sgds-container-sidebar for internal tools, dashboards, admin portals, and transactional applications.