Docs: remove Surface 3 from Surfaces and elevations - #30
Merged
Conversation
Reduce the surface system from three colors to two. Surface 3 was a subtle tint used to mark internal structure (table headers, page banners); it's being retired, leaving Surface 1 and Surface 2. - Drop Surface 3 from the surfaces table and remove its own section - Remove the Page banner row from the combinations table - Update "three surface colors" to "two", and the usage heading/body and accessibility copy that referenced Surface 3 - Swap in hi-res (4x) images for the swatches, Mid elevation, combinations diagram, and the first usage-guidelines figure Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A new build was pushed to Chromatic! 🚀 |
jonahgoldsaito
approved these changes
Aug 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Reduces the surface system in Foundations → Surfaces and elevations from three surface colors to two, retiring Surface 3.
Content changes
surface3Imgimport and trimmed Surface 3 mentions from threealttextsImage updates
Swapped in new hi-res (4×) exports from Figma for:
surfaces-overview.png) — now shows only Surface 1, Surface 2, Surface scrimelevation-mid.png)combinations.png) — combinations diagram no longer includes the Surface 3 / Page banner layerusage-surface-base.png)Why
Surface 3 is being retired from the design system. This brings the documentation in line with the two-surface model.
Notes for reviewers
assets/surfaces-and-elevations/surface-3.pngis left in the repo but is now unreferenced; happy to delete in a follow-up if preferred.🤖 Generated with Claude Code