-
Notifications
You must be signed in to change notification settings - Fork 521
Open
Description
Overview
The Base Brand Kit contains multiple visual assets (logos, icons, wordmarks) that may evolve over time. Currently, consumers downloading or embedding these assets have no clear way to detect updates or manage cache invalidation when assets change.
Problem Description
Teams using the Brand Kit often:
- cache assets locally or via CDN
- embed assets directly into websites or apps
- need to know when a logo or asset has been updated
Without a versioned manifest, updates can be missed or require manual comparison.
Expected Behavior
- Consumers should be able to easily determine the current version of brand assets.
- Asset updates should be discoverable without manual inspection.
- Cache invalidation should be straightforward.
Steps to Reproduce
- Download or reference assets from the Brand Kit.
- Return later to check for updates.
- Observe there is no clear indication of asset versioning or change history.
Example
```text
logo.svg
logo-dark.svg
icon.svg
# No version or manifest indicating last update
Proposed Solution
- Add a machine-readable, versioned asset manifest file (e.g.
brand-manifest.json) to the repository. - Include metadata for each asset such as name, version or revision hash, and last updated date.
- Update the manifest whenever any brand asset is modified or added.
- Document basic usage of the manifest for cache invalidation and update detection.
Acceptance Criteria
- A versioned asset manifest exists and is kept up to date.
- Asset changes are accurately reflected in the manifest.
- Consumers can programmatically detect asset updates using the manifest.
- No breaking changes to existing asset file paths or names.
Metadata
Metadata
Assignees
Labels
No labels