Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Project proposal for dark mode project #3913

Merged
merged 15 commits into from
Mar 25, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# 2024-03-13 Project Proposal

**Author**: @fcoveram

## Reviewers

<!-- Choose two people at your discretion who make sense to review this based on their existing expertise. Check in to make sure folks aren't currently reviewing more than one other proposal or RFC. -->

- [ ] @obulat
fcoveram marked this conversation as resolved.
Show resolved Hide resolved
- [ ] @zackkrida
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

## Project summary

<!-- A brief one or two sentence summary of the project's features -->

Include a feature that changes the UI from light to a dark color scheme.

### Motivation

Dark mode is a customization level that is in the spirit of adapting the UI to
people’s contexts. The benefits span a11y, personal preferences set on the
fcoveram marked this conversation as resolved.
Show resolved Hide resolved
devices, energy efficiency in devices, and an alternative browsing experience of
visual content due to the background contrast.

## Goals

<!-- Which yearly goal does this project advance? -->

Refine Search Experience

## Requirements
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

<!-- Detailed descriptions of the features required for the project. Include user stories if you feel they'd be helpful, but focus on describing a specification for how the feature would work with an eye towards edge cases. -->

1. Design documentation of pages and UI components in the Design Library and any
other additional Figma files.
2. Design documentation of transition from current to new frontend
implementation.

## Success

<!-- How do we measure the success of the project? How do we know our ideas worked? -->

fcoveram marked this conversation as resolved.
Show resolved Hide resolved
- Add the dark theme to the site by allowing visitors to change the UI through
three options: Light theme, Dark theme, or follow device setting.
- Document the dark variant of every UI element in both the Design Library and
Storybook.
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

## Participants and stakeholders

<!-- Who is working on the project and who are the external stakeholders, if any? Consider the lead, implementers, designers, and other stakeholders who have a say in how the project goes. -->

- Lead: @fcoveram
- Design: @fcoveram
- Implementation: TBD

## Infrastructure

<!-- What infrastructural considerations need to be made for this project? If there are none, say so explicitly rather than deleting the section. -->

TBD
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

## Accessibility

<!-- Are there specific accessibility concerns relevant to this project? Do you expect new UI elements that would need particular care to ensure they're implemented in an accessible way? Consider also low-spec device and slow internet accessibility, if relevant. -->

- Follow the advisor of WCAG 2.2 to meet AA. Put special attention to the
[Perceivable section](https://www.w3.org/WAI/WCAG22/quickref/?currentsidebar=%23col_overview&levels=aaa&showtechniques=321#principle1).
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

## Marketing

<!-- Are there potential marketing opportunities that we'd need to coordinate with the community to accomplish? If there are none, say so explicitly rather than deleting the section. -->

Since the project involves visual changes across the site, there is a marketing
opportunity to introduce the benefits of the UI’s dark theme.
fcoveram marked this conversation as resolved.
Show resolved Hide resolved

## Required implementation plans

<!-- What are the required implementation plans? Consider if they should be split per level of the stack or per feature. -->

Frontend implementation plan.
Loading