Skip to main content

About This Deliverable

The Texas Design System is a one-time deliverable of ready-to-use HTML/CSS components and best-practice guidance. Upon delivery, the agency takes full ownership and is responsible for implementation choices, maintenance, evolution, and distribution to other agencies.

Handoff package

This engagement hands off a complete documentation site.

  • Includes: component documentation pages, copy-ready HTML examples, and CSS/JS assets under assets/
  • Package is ready to open, review, customize, and share as-is.

Updating after handoff

This is a one-time deliverable handoff. Future updates are made directly in the delivered site files.

To add a new component in the delivered package:

  1. Add or update CSS in assets/css/design-system.css
  2. If the component is interactive, add or update JavaScript in assets/js/design-system.js
  3. Add component markup in the relevant component page HTML
  4. Create a new component docs page at components/[name]/index.html
  5. Add a link to the new component from components/index.html

Recommended: keep class names consistent with the existing Block Element Modifier (BEM) pattern (txds-[component]__[element]--[modifier]) and validate accessibility after each change.

What's included in the deliverable

Asset Description
Documentation site Generated pages with component reference and copy-ready examples
Ready-to-use CSS assets/css/design-system.css (compiled from all components)
Ready-to-use JavaScript assets/js/design-system.js (compiled interactive component scripts)
Site CSS assets/css/site.css (documentation styling)
Doc-site JavaScript assets/js/copy-code.js (copy-to-clipboard feature for examples)
HTML examples Copy-ready markup embedded in each component page
Integration guides Static HTML and Drupal guidance

External standards reference

For implementation and governance alignment, reference the DIR Web Modernization Best Practice Standards: