Skip to content
Merged
Show file tree
Hide file tree
Changes from all 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
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,31 @@

All notable changes to mCSS. The framework follows the copy-it-you-own-it model: there is no package to update, so version numbers mark states of the repository you can copy from (each release is also a git tag).

## 1.4.0 (2026-08-16)

The default theme: the framework now ships as structure plus one swappable file holding every design value, a new `external` layer makes third-party CSS easy to override, and the docs got a full restructure ([#65](https://github.com/minimaldesign/mCSS/issues/65)).

### Breaking

- **The `settings.*` design files become the default theme.** `settings.tokens.css` and `settings.ui.css` are now `theme.default.tokens.css` and `theme.default.ui.css`, imported by the new `theme.default.css` entry. `mcss.css` no longer carries any design values: your entry must activate the default theme right after it (`@import url(./framework/theme.default.css);`), and nothing paints without it.
- **The `theme` layer splits into `theme.default` and `theme.user`.** The default theme's parts land in `theme.default`; your own theme self-layers into `theme.user`, so your overrides beat the default no matter the import order. The full layer statement is now `base, elements, global, components, theme.default, theme.user, external, helpers`.
- **`theme.wireframe.css` is a composed entry**: it imports the default theme itself and holds only its deviations. Activate it INSTEAD of `theme.default.css`.
- **The feedback alias tier is gone.** The `--success-*` / `--danger-*` / `--warning-*` aliases are removed; components and themes use the `--yes-*` / `--no-*` / `--maybe-*` palettes directly.
- **`dist/mcss.css` bakes the default theme in**, so the single-file drop-in keeps painting on its own. `dist/css/mcss.css` (the per-file `@import` index) ships with the default theme import active and is now ordered by cascade layer.
- **Docs URLs restructured**: tokens + themes → `/docs/default-theme`, reset + elements → `/docs/default-html`, global + media queries → `/docs/layout`, Installation and Browser Support split out of Getting Started, and the marketing template lives on the new `/docs/components`. Every old URL (including the `.md` twins) 301s.

### Added

- **`external` cascade layer**, empty by default, between `theme.user` and `helpers`: import third-party CSS with `@import url(…) layer(external);` and it beats the framework but loses to all your unlayered CSS, at any specificity. Companion convention: `patch.*.css` files (like this site's `patch.astro.css`) hold your fixes to vendor styles.
- **`theme.starter.css`**: the starting point for writing your own theme.
- **`check-layers.mjs`** (`npm run check:layers`, wired into pre-commit and CI): the layer statement is deliberately duplicated (theme pins, docs code blocks, dist), so the build now derives it from `mcss.css` and the check fails when any copy drifts. `--fix` rewrites stale copies.
- Docs: dedicated Installation, Browser Support (with a version floor table), and Components pages; anchor scrolling clears the sticky header on mcss.dev.

### Fixed

- The marketing template imports `mcss.components.css` and `theme.default.css` (it rendered unstyled after the restructure).
- All redirects are real Netlify 301s in `public/_redirects`. Astro's config redirects emit meta-refresh HTML stubs, which broke `.md` twin fetchers (a 200 with HTML where agents expect markdown) and shadowed the edge rules.

## 1.3.0 (2026-07-31)

The compile floor now matches the docs: mCSS targets Baseline 2024, and the build stops polyfilling the features the framework was always meant to use natively ([#56](https://github.com/minimaldesign/mCSS/issues/56)).
Expand Down
2 changes: 1 addition & 1 deletion dist/css/base.reset.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.avatar.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.badge.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.banner.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.breadcrumbs.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.button.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.card.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.faq.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.featureItem.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.field.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.fieldRow.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.footer.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.header.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.hero.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.notice.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.pagination.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.prevNext.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.pricing.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.readProgressBar.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.section.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.socialMedia.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.tags.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.testimonial.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.tiles.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.toc.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/component.toggle.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.form.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.interactive.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.media.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.sectioning.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.table.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.text.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/elements.text.quotes.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.a11y.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.animation.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.grid.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.layout.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.prose.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/global.wrap.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.colors.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.devtools.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.layout.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.opacity.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.ratios.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.spacing.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/help.typography.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/mcss.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
@layer base, elements, global, components, theme.default, theme.user, external, helpers;
@import url(./base.reset.css) layer(base);
@import url(./elements.form.css) layer(elements);
Expand Down
2 changes: 1 addition & 1 deletion dist/css/theme.default.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/* DEFAULT THEME */

/*
Expand Down
2 changes: 1 addition & 1 deletion dist/css/theme.default.tokens.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/theme.default.ui.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/theme.starter.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/css/theme.wireframe.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
SETTINGS MEDIA QUERIES

Expand Down
2 changes: 1 addition & 1 deletion dist/mcss.components.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */
/*
mCSS component library entry point.

Expand Down
2 changes: 1 addition & 1 deletion dist/mcss.components.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dist/mcss.css
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/*! mCSS v1.3.0 | MIT | https://mcss.dev */
/*! mCSS v1.4.0 | MIT | https://mcss.dev */

@layer base, elements, global, components, theme.default, theme.user, external, helpers;
@layer base, elements, global, components, theme.default, theme.user, external, helpers;
Expand Down
2 changes: 1 addition & 1 deletion dist/mcss.min.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "mcss",
"type": "module",
"version": "1.3.0",
"version": "1.4.0",
"license": "MIT",
"scripts": {
"dev": "astro dev",
Expand Down
Loading