hackforla / hackforla/tdm-calculator

Design system and site audit: Icons

Open
#2,227 31 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

deck: staging deck: stakeholder presentation draft feature: style guide level: easy Participant type: Admin Participant Type: Security Admin priority: MUST HAVE ready for product role: ui/ux design size: 5pt
Dominant language
JavaScript
Stars
68
Forks
47
Avg merge
3d 9h
Merged PRs (30d)
25

Description

Overview

Update the design system's listing of iconography to accommodate recent additions and changes.

Details

Our design system has multiple issues.

  • Missing icons
    • Ex. Sort icons
  • Icons that are present are inconsistent in their style
    • Ex. Create Project pagination icons use the Material Design "Rounded" style while the ones on the My Project page use the "Outlined" style. Icons should use the "Filled" style, and exceptions—and their reasons for being exceptions—should be made explicit in the design system.
    • Use the LADOT Style Guide listed in the Resources section as a guide when choosing icon styles.
  • Icons have the wrong color and size
    • Ex. The filter icon appears as black in our design system but appears as white and navy blue on the site
  • Icons are missing context
    • Ex. The CSV Download icon is from Font Awesome, and that's because the stakeholders wanted that icon specifically, even though it does not conform to the rest of the Material Design library we're using.

Please conduct an audit of our design system and ensure that all icons are listed, consistent, accurate, and explained.

Once the audit has been conducted, please make sure that the site is consistent with the updated design system.

Action Items
  • Create a slide for this issue on the Staging deck and add to resources below
  • Update the iconography in Figma design system.
    • Add missing icons.
    • Make icon styles consistent.
    • Make icon colors and size accurate.
    • Add missing context about icon usage.
  • Write bugs for any instances where the Dev site is inconsistent with the updates made to the iconography in the design system.
  • Review with the design team. Update if needed based on feedback.
  • Review with the product, development, and research teams. Update if needed based on feedback.
  • Get Stakeholder sign-off via the stakeholder meeting slide deck.
  • Update the Style Guide Presentation with any updates from this issue.
  • Reassign any previous assignees to this issue.
  • Close this issue.
Resources
Figma
Google Drive
Slides

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Figma Full Design System and compare its iconography with the LADOT Style Guide and the examples in this issue. Done means all icons are listed, consistent, accurate, and documented with their usage context, site inconsistencies have follow-up bugs, and the required team reviews and stakeholder sign-off are complete.

Written by the indexing model from the issue text.

Assessment

Tech stack
figma
Domain
design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.