Epic CSS / Documentation

Changelog

Release history for the epic-css package, newest first. The latest release is 0.14.3.

Dates are UTC publication dates. Early entries were reconstructed from the repository history; where a version has no recorded source, its entry says so instead of listing changes. To pin a version, replace the number in npm install epic-css@0.14.3 --save-exact.

0.14.4 (Unreleased)

Planned changes after 0.14.3, not yet published

Added

Optional SVG helpers in the image module: .icon for inline alignment and flex-shrink prevention, and .icon-16, .icon-24, .icon-32, .icon-48 for explicit pixel dimensions. The helpers work with any SVG collection and include no icon assets.
Workshop Icons page with 21 original outline SVGs, live sizing, copy controls and labeled interface examples.

Changed

The npm publish workflow retries its post-publish install check while the registry makes a new version available.

Compare changes

0.14.3

LatestReleased November 12, 2026

Added

.btn button base: inline-flex alignment, current-color border, 4px radius, inherited font and color, a :focus-visible outline and a :disabled state.
.btn-primary and .btn-secondary variants using the palette text and background colors.
.grid-sidebar-right-344: one column that becomes main content plus a 344px right sidebar from 1040px.
.flex-2 (flex: 2).

Changed

The base reset targets only h1–h6 and sets line-height: normal on them. p and ul no longer receive the zero margin and padding reset.
Article typography (heading sizes, paragraph and list spacing) applies only to article.post, not every article. Add the post class to keep these styles.
The publish workflow installs the newly published version in a temporary project to verify it.

0.14.2

Released November 11, 2026

Added

From a module checkout, npm run build and npm run epic-compile compile the full library into build/<package-version>.css with a matching source map that embeds the Sass sources. Older versioned files are kept.
test/build.cjs checks the versioned filename, portable map reference, retained older artifacts and compilation failures. npm test runs it with the palette test.
.flex-md (flex from the md breakpoint, 820px) and .flex-1.
Sidebar grid utilities: .grid-sidebar-left (one column), .grid-1fr-4fr-md (1fr 4fr from 820px, stacking again from 960px to 1024px), and .lg-grid-sidebar-left-25, -30 and -40 (percentage left column wider than 1024px).

Changed

$container-width is a !default, so a value assigned before importing the library is kept.
body margin is 0 instead of 3px.
The automatic bottom margin on post images uses :where(.post) img instead of article img, so explicit margin utilities override it.

0.14.1

Released November 6, 2026

Prepared from the published 0.14.0 source.

Added

Compiled CSS regression checks for default colors and consumer overrides. npm test runs them, and prepublishOnly runs the tests before publishing.

Changed

Document actual palette utilities, source-filter limitations and the site-first release workflow.
Limit package contents to Sass source, the two build/filter scripts, the regression test and documentation; generated pre-light CSS and maps are no longer published.
Publish from GitHub releases through the npm trusted-publishing workflow.

Fixed

Preserve all eight consumer palette values assigned before importing the library by declaring fallback colors with !default.

0.14.0

Released March 24, 2025

Published without a matching commit in this repository, so changes in 0.12.0, 0.13.0 and 0.14.0 cannot be separated. Compared with the 0.11.0 source, the published 0.14.0 source has these changes.

Added

Font ramp utilities fs-12 to fs-96, lh-12 to lh-96, fw-400, fw-600, fw-700, lh-normal and text-nowrap, backed by :root custom properties that change at 1084px and narrower.
Article heading sizes from the font-ramp properties, plus heading, paragraph and list spacing inside article.
ul.list-none to remove list bullets.
An empty _custom.scss partial.
epic-light scans .md files, always keeps :root rules and writes to outputFileName from epicConfig.js.

Changed

index.scss imports the font ramp before base styles.
The base reset sets margin and padding to 0 on headings, p and ul. Lists keep their bullets unless list-none is used.

Removed

text-xs, text-sm, text-lg, text-xl, font-bold and the $text-* variables.
.h1–.h4 and .lh-0.
Global li margins and the main paragraph, h2 and iframe margins.

npm 0.14.0

0.13.0

Released March 21, 2025

Published without a matching commit in this repository. See 0.14.0 for the combined changes after 0.11.0.

npm 0.13.0

0.12.0

Released March 20, 2025

Published without a matching commit in this repository. See 0.14.0 for the combined changes after 0.11.0.

npm 0.12.0

0.11.0

Released March 19, 2025

0.9.0 and 0.10.0 have no matching commits, so this entry includes all changes since 0.7.0.

Added

.clr-white and $clr-white, .border-none.
.flex-col-reverse, .flex-basis-300 and .left-sidebar-sm (a sidebar grid from 756px).
.position-relative, .position-absolute, .overflow-x-auto, .scroll-snap-x-mandatory, .snap-start, .scroll-smooth, .cursor-pointer, .z-100 and .lh-0.
Bottom margins for list items, including Markdown list items containing paragraphs.

Changed

Paragraph and h2 spacing applies only inside main, no longer article; iframe elements in main get a bottom margin.
Code blocks scroll horizontally only.

Removed

a.underline-clr styles.
Unused shade variables such as $clr-primary-dark, $clr-secondary-dark and their background variants.

0.10.0

Released March 10, 2025

Published without a matching commit in this repository. Its changes are included in the 0.11.0 entry.

npm 0.10.0

0.9.0

Released March 10, 2025

Published without a matching commit in this repository. Its changes are included in the 0.11.0 entry.

npm 0.9.0

0.7.0

Released June 8, 2024

0.5.0 and 0.6.0 have no matching commits, so this entry includes all changes since 0.4.0.

Added

.clr-primary-bg, .clr-secondary-bg, .border-r-4 and .border-r-16.
$clr-body for body and link text color.
Link styles in main and article, circle bullets for article lists, and styled pre and inline code.
Spacing scale $spacers in rem: 0, 4, 6, 8, 10, 12, 16, 18, 20, 24, 32, 40, 56, 60, 64, 80 and 100.

Changed

New default palette: #2e106a background, #ffffff text, #00d886 primary and #c6c9e5 secondary.
Gap, padding and margin utilities are generated from $spacers; the 2 step was removed.
.grid-col-2 and .grid-col-3 auto-fit columns at all widths (minimum 331px and 270px) instead of only from 900px.
epic-light keeps each matching media query block once, after other rules.
The package homepage is https://epiccss.com.

0.6.0

Released May 27, 2024

Published without a matching commit in this repository. Its changes are included in the 0.7.0 entry.

npm 0.6.0

0.5.0

Released May 23, 2024

Published without a matching commit in this repository. Its changes are included in the 0.7.0 entry.

npm 0.5.0

0.4.0

Released March 4, 2024

Added

_variables.scss settings for heading sizes and weight, body size and line heights, body background, and primary and secondary colors.
Spacing step 6.

Changed

Palette variables use a $clr- prefix.
a.underline-clr became a.clr-underline, and .bg-color became .clr-body-bg.
epic-light always keeps pre and code styles.

Removed

.bg-black.

0.3.0

Released February 26, 2024

Added

epic-build and epic-light package scripts, configured by a project epicConfig.js, to compile the full stylesheet and filter it to classes used in project files.
$container-width (default 1000px) for .container.
Body font size, and article list styles.

Changed

_spacing.scss was renamed to _spacers.scss.

0.2.0

Released February 20, 2024

First version with source in this repository.

Added

Sass partials for base styles, font ramp, colors, images, grid and flexbox, and spacing, with src/index.scss importing them all.
Draft build and class-filter scripts.
README installation guide.

0.1.0

Released February 12, 2024

First npm publication. The repository has no source or notes for this version.

npm 0.1.0

These notes come from CHANGELOG.md in the library repository.