Skip to content

Collapse the atoms cascade layer into components - #29

Merged
minimaldesign merged 1 commit into
mainfrom
collapse-atoms-layer
Jul 21, 2026
Merged

Collapse the atoms cascade layer into components#29
minimaldesign merged 1 commit into
mainfrom
collapse-atoms-layer

Conversation

@minimaldesign

Copy link
Copy Markdown
Owner

Summary

Folds the atoms cascade layer into components ahead of v1. The split did no cascade work (cross-component class coupling is banned, so layer order between atoms and components never broke a tie, and no component CSS overrides an atom class), and its docs definition could not classify Badge unambiguously. The one real distinction, CSS-only with no Astro file needed, is kept as a property instead of a category.

  • atom.badge|button|toggle.css renamed to component.*.css; class names (.bt, .badge, .toggle), theme tokens, and docs URLs unchanged
  • Layer list is now settings, base, elements, global, components, pages, helpers
  • Content schema: type enum drops "atom"; new optional cssOnly flag marks class-only components and drives the "(CSS-only)" label in /llms.txt
  • Components sidebar and header nav merge into one alphabetical list
  • build-css.mjs wipes dist/css/ before rebuilding so renames can't leave stale outputs; this also removed two long-orphaned dist files (component.articleCard.css, component.postList.css)
  • Docs updated throughout: docs/start (Atoms section folded into Components), badge/button/toggle pages, card, pricing, the structure blog post, agents/*.md, DESIGN.md, and the CI layer-statement check

BREAKING CHANGE for anyone copying individual files from 0.9: atom.*.css paths and the atoms layer are gone. The pre-change tree is preserved at the v0.9.0 tag; the full migration story lands in the v1.0.0 release notes.

Verification

  • npm run build:css: clean dist, zero atom occurrences, new layer statement in both bundles
  • npm run build: 101 pages, validates the schema change
  • Preview server: merged 22-item sidebar, no Atoms nav group, badge and .bt computed styles resolve from the components layer on the badge and pricing pages, (CSS-only) labels in /llms.txt, no console errors

🤖 Generated with Claude Code

The atoms/components split did no cascade work: cross-component class
coupling is banned, so layer order between atoms and components never
broke a tie, and no component CSS overrides an atom class. The split
survived only as taxonomy, and its docs definition could not classify
Badge unambiguously. The real distinction (CSS-only, no Astro file
needed) is now a property instead of a category.

- Rename atom.badge|button|toggle.css to component.*.css
- Layer list is now: settings, base, elements, global, components,
  pages, helpers
- Frontmatter type enum drops "atom"; new optional cssOnly flag drives
  the "(CSS-only)" label in /llms.txt
- Merge the components sidebar and header nav into one list
- build-css.mjs now wipes dist/css before rebuilding, which also
  removes two long-orphaned files (articleCard, postList)
- Update docs, blog structure post, agents/ references, DESIGN.md, CI

BREAKING CHANGE: the atoms layer and atom.*.css file paths are gone.
Class names, theme tokens, and docs URLs are unchanged. The pre-change
tree is preserved at the v0.9.0 tag.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 21, 2026

Copy link
Copy Markdown

Deploy Preview for mcssdev ready!

Name Link
🔨 Latest commit 8c17dc9
🔍 Latest deploy log https://app.netlify.com/projects/mcssdev/deploys/6a5f939e766bd90008838612
😎 Deploy Preview https://deploy-preview-29--mcssdev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 97
Accessibility: 96
Best Practices: 100
SEO: 99
PWA: 70
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@minimaldesign
minimaldesign merged commit d35bbf8 into main Jul 21, 2026
5 checks passed
@minimaldesign
minimaldesign deleted the collapse-atoms-layer branch July 22, 2026 01:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant