TWE: Dev: Design System: Create (redo) buttons

[revforyou]

Overview

We need to redo the Design System Button Component HTML and SASS / connect Figma design to finished code, and build a microsite page so that developers can see and easily change component examples, states, code, and location using Material as a baseline.

Assumptions

• You have read the CONTRIBUTING.md in the Design System repo
  • You have set up your development environment for working with the Internship Design System Repository: https://github.com/hackforla/internship-website-design-system
  • You will continue to follow the instructions in the CONTRIBUTING.md file

Action Items

• Review the Microsite page mockup you will be working from (Resource 1.01)
• Review the Material Design Kit and identify the relevant component, variants, and states (Resource 1.13)
• Review Code Standards before starting implementation
• Name the Branch you create [Replace with NAME OF COMPONENT]
• Determine if any JavaScript needs to be included to style this component (see Resource 1.02 for examples of included JavaScript). If you do need to use JS, don't forget to update the wiki page
• Include necessary files in the /docs folder (Resource 1.03) and project config file mkdocs.yml (Resource 1.04)
• Determine what tokens are needed for this component
  • Reuse existing tokens where possible
  • Add new tokens only if necessary
• Code Microsite component page file locations
  • md file goes into the /docs folder (Resource 1.03)
  • SASS file goes into the /docs/components/sass/components folder (Resource 1.06)
  • Create tokens as necessary, reusing existing tokens where possible; add new color tokens only if required and name them using HTML Color Code conventions (Resources 1.07, 1.08)
  • Create component classes and states within the page
  • Include Files via code snippets to create the code section (see Resource 1.09 for details)
  • Add links to SASS and Markdown files below the code (see examples in Resource 1.10)
• Review template frontend for errors
• Make a PR
• Once PR is merged
  • connect component in Figma to GitHub Files (Resource 1.10)
  • Add links to Resources gathered during the completion of this issue section
    • 2.01 MD file(s) created
    • 2.02 SASS file(s) created
    • 2.03 link to Header Microsite page on live site: If the site is live when this issue is worked on.

Resources

Resources for working on this issue

• 1.01 Design Reference
  • Design Systems Figma
• 1.02 WIKI: Design system microsite JavaScript
• 1.03 MKdocs folder: /docs on repo
• 1.04 MDdocs config file: mkdocs.yml on repo
• 1.05 variables file: /docs/components/sass/abstracts/_variables.scss on repo
• 1.06 SASS file folder: /docs/components/sass/components
• 1.07 Variables SASS Sheet: /docs/components/sass/abstracts/variables.sss
• 1.08 HTML Color Code Names: HTMLColorCodes.com
• 1.09 WIKI: How to Create a Design System Microsite Page using Snippets
• 1.10 Naming conventions:
  • below the CSS tab, it would say CSS: https://github.com/hackforla/internship-website-design-system/blob/main/docs/components/sass/components/_[Replace with NAME OF COMPONENT].scss
  • below the HTML tab it would say HTML: https://github.com/hackforla/internship-website-design-system/blob/main/docs/[Replace with NAME OF COMPONENT].md
• 1.11 Connect component in Figma to GitHub Files
• 1.12 Original Design Issue: [Replace with LINK TO DESIGN ISSUE FROM EPIC]
• 1.13 Material Design Kit (Figma)
• Microsite Epic Issue with list of design issues: Develop Design System Microsite based on Material for MKDocs #455 (comment)

Resources gathered during the completion of this issue

• 2.01 MD file(s) created: buttons.md - https://github.com/hackforla/internship-website-design-system/blob/main/docs/buttons.md
• 2.02 SASS file(s) created: buttons.scss - https://github.com/hackforla/internship-website-design-system/blob/main/docs/components/sass/components/_buttons.scss
• 2.03 link to Header Microsite page on live site: https://hackforla.github.io/internship-website-design-system/buttons/
• 2.04 Updated Token File: tokens.scss - https://github.com/hackforla/internship-website-design-system/blob/main/docs/components/sass/abstracts/_tokens.scss

[revforyou]

Update

Last week, I implemented the Buttons component with token-based styling support.

Work completed:

• Added primary and secondary button classes
• Implemented hover, active, and disabled states.
• Integrated shared design tokens through tokens.css.
• Aligned the component structure with Material-based styling conventions.

Changes are now pushed via PR and are ready for review.