# Gsa Usds

> Builds dense operational federal React interfaces with GSA TTS's A U.S. Design System, semantic tokens, accessible components, and light/dark modes. Use for staff tools, dashboards, permitting, and similar systems that explicitly choose this pre-npm Git distribution; it is not USWDS — use the uswds skill for USWDS work.

- Skill: `blencorp/gsa-usds` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add blencorp/gsa-usds`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blencorp/gsa-usds/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: blencorp (https://skillmd.com/u/blencorp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blencorp/gsa-usds

---


# GSA TTS A U.S. Design System

## Before editing

1. Confirm the product is inside this system's scope.
2. Read [references/implementation.md](references/implementation.md) before installing, copying, or changing upstream assets.
3. Read [references/sources.md](references/sources.md) for provenance, version, and license.
4. Inspect and preserve the target project's framework, package manager, asset pipeline, and accessibility tests.

## Workflow

1. Choose one documented delivery path and pin an exact package, commit, release, or downloaded asset snapshot.
2. Use only official components, tokens, templates, and examples that are actually public.
3. Extend through documented mechanisms. Label every unsupported addition as custom.
4. Record the upstream version or commit and the accepted maturity/maintenance risk.
5. Test keyboard operation, focus, names/roles/states, errors, status messages, contrast, zoom/reflow, responsive behavior, and supported browsers.

## Boundaries

- **Scope:** Dense operational federal applications. Do not confuse this React system, named USDS, with the government-wide U.S. Web Design System (USWDS).
- **Delivery:** React and TypeScript components installed directly from the official Git repository.
- **Release:** Installed from the official GitHub repository; no npm package is published. Pin an exact commit or tag.
- Do not invent a registry package, public repository, component API, or release commitment.
- Do not imply that a beta, hosted asset, code example, or product-specific repository is government-wide.
- Do not claim legal or WCAG conformance for the completed service solely from component use.
- If this system does not fit the product's requirements, route to the governing system or stop and explain the gap.

## References

- [Implementation](references/implementation.md)
- [Sources](references/sources.md)