hackforla / hackforla/internship
TWE: Dev: Design System: Create (redo) buttons
- Dominant language
- CSS
- Stars
- 20
- Forks
- 6
- PR merge metrics
- No merged PRs in 30d
Description
### 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](https://github.com/hackforla/internship-website-design-system/blob/main/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
- [x] Review the Microsite page mockup you will be working from (Resource 1.01)
- [x] Review the Material Design Kit and identify the relevant component, variants, and states (Resource 1.13)
- [x] Review Code Standards before starting implementation
- [x] Name the Branch you create [Replace with NAME OF COMPONENT]
- [x] 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
- [x] Include necessary files in the `/docs` folder (Resource 1.03) and project config file `mkdocs.yml` (Resource 1.04)
- [x] Determine what tokens are needed for this component
- [x] Reuse existing tokens where possible
- [x] Add new tokens only if necessary
- [x] Code Microsite component page file locations
- [x] md file goes into the /docs folder (Resource 1.03)
- [x] SASS file goes into the /docs/components/sass/components folder (Resource 1.06)
- [x] 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)
- [x] Create component classes and states within the page
- [x] Include Files via code snippets to create the code section (see Resource 1.09 for details)
- [x] Add links to SASS and Markdown files below the code (see examples in Resource 1.10)
- [x] Review template frontend for errors
- [x] Make a PR
- Once PR is merged
- [x] connect component in Figma to GitHub Files (Resource 1.10)
- [x] Add links to `Resources gathered during the completion of this issue` section
- [x] 2.01 MD file(s) created
- [x] 2.02 SASS file(s) created
- [x] 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](https://www.figma.com/file/TTRS2FWXsrymHYpPJL1IdH/Internship-Team-Main-file?type=design&node-id=2%3A45&mode=design&t=jgMN8QdoLnh9F7MT-1)
- 1.02 WIKI: [Design system microsite JavaScript](https://github.com/hackforla/internship/wiki/Design-system-microsite-javascript)
- 1.03 MKdocs folder: [/docs](https://github.com/hackforla/internship-website-design-system/tree/main/docs) on repo
- 1.04 MDdocs config file: [mkdocs.yml](https://github.com/hackforla/internship-website-design-system/blob/main/mkdocs.yml) on repo
- 1.05 variables file: [/docs/components/sass/abstracts/_variables.scss](https://github.com/hackforla/internship-website-design-system/tree/main/docs/components/sass/abstracts) on repo
- 1.06 SASS file folder: [/docs/components/sass/components](https://github.com/hackforla/internship-website-design-system/tree/main/docs/components/sass/components)
- 1.07 Variables SASS Sheet: [/docs/components/sass/abstracts/variables.sss](https://github.com/hackforla/internship-website-design-system/tree/main/docs/components/sass/abstracts/variables.scss)
- 1.08 HTML Color Code Names: [HTMLColorCodes.com](https://htmlcolorcodes.com)
- 1.09 WIKI: [How to Create a Design System Microsite Page using Snippets](https://github.com/hackforla/internship/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](https://github.com/hackforla/internship/wiki/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)](https://www.figma.com/community/file/1035203688168086460/material-3-design-kit)
- Microsite Epic Issue with list of design issues: https://github.com/hackforla/internship/issues/455#issuecomment-2057437256
#### 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
Contributor guide
Assessment
This issue has not been assessed yet.