Skip to main content

Component standards

Component criteria

  1. Must be brand aligned and assessed by Design Direction (if applicable)
    • New user experience patterns must involve Design Direction to preserve a high-quality and consistent end customer experience
  2. Must be sufficiently different from other available components
    • Improve user experience through familiarity and recognition of consistent and repeatable patterns
    • Reduce duplication by promoting flexibility and reuse of existing code
    • Before creating a new component, consider whether an existing pattern and component is sufficient. If not, consider extending or adding features to an existing component before creating a new one
  3. Must not include business logic or proprietary information
    • Business logic and proprietary information limits resuability
    • Keep business logic, API calls, content, or other application-specific behaviour in the application
    • Focus on reusable functionality that can accept predictable data types
  4. Should be sufficiently granular to promote reuse
    • Components should encapsulate a single pattern or element
    • Seek to find the most granular, standalone, reusable pattern

Component principles

  1. Composable: Components are most effective when they can be combined to form more complex patterns
  2. Accessible: Follow TELUS Reference Architecture accessibility standards
  3. Responsive: Mobile-first, works on any viewport size
  4. Quality: Thorough testing is a first class concern
  5. Browser support: Make sure components work for various browser and screen reader combinations