base / base/brand-kit

Add clear guidance on dark-mode and light-mode asset usage

Open
#73 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
1.5k
Forks
534
PR merge metrics
No merged PRs in 30d

Description

### Overview
The Base Brand Kit includes multiple logo and asset variants, but it is not always clear which assets should be used in light-mode vs dark-mode contexts. Explicit guidance would help teams apply the brand consistently across different UI themes.

### Problem Description
Developers and designers may be unsure about:
- which logo variants are intended for dark backgrounds
- whether color inversion is allowed or discouraged
- how to choose correct assets for light/dark UI themes
- consistent usage across web, mobile, and marketing materials

This can lead to inconsistent or incorrect brand presentation.

### Expected Behavior
- Consumers should easily understand which assets to use in light and dark contexts.
- Brand usage should remain consistent across themes and platforms.
- Asset selection should not require guesswork.

### Steps to Reproduce
1. Open the Base Brand Kit repository.
2. Browse available logo and icon assets.
3. Attempt to choose assets for both light and dark UI themes.
4. Notice the lack of explicit guidance on correct usage.

### Proposed Solution
- Add a documentation section titled “Light & Dark Mode Usage”.
- Clearly specify:
- which logo variants are intended for light backgrounds
- which variants are intended for dark backgrounds
- any restrictions on color modification or inversion
- Include simple visual examples demonstrating correct usage.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.