From d4bd6e2620d31819866a8ba76a9146611a31b801 Mon Sep 17 00:00:00 2001 From: Akib Date: Sat, 12 Sep 2026 16:49:00 +0600 Subject: [PATCH 1/2] docs: lead with dashboards as a use case, not only photo galleries MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The library was written for a dashboard — charts and KPI cards of different heights, where a CSS Grid leaves a stripe of empty space under every short card — but the docs described it as a Pinterest-style photo layout, which is the narrower of the two audiences and not the one it was built for. The npm README and llms.txt now name both. llms.txt matters here because it is what an AI assistant reads: asked for help with an Angular dashboard layout, it previously had nothing to connect this package to the question. Adds dashboard, dashboard-layout, charts, widgets and cards to the package keywords for the same reason. --- llms.txt | 8 +++++--- projects/masonry-angular/README.md | 3 +++ projects/masonry-angular/package.json | 5 +++++ 3 files changed, 13 insertions(+), 3 deletions(-) diff --git a/llms.txt b/llms.txt index 1d51acd..84e22d0 100644 --- a/llms.txt +++ b/llms.txt @@ -1,8 +1,10 @@ # masonry-angular -> Cascading grid ("masonry") layout for Angular — the Pinterest-style layout where columns are equal -> width, items have different heights, and each item goes into the shortest column. Zero runtime -> dependencies, 8.6 KB gzipped, signal-based, zoneless, SSR-safe. Works on Angular 17.1 through 22. +> Cascading grid ("masonry") layout for Angular — columns are equal width, items have different +> heights, and each item goes into the shortest column instead of waiting for a new row. Use it for +> photo galleries and, just as often, for dashboards of charts and KPI cards, where a normal CSS +> Grid leaves empty space under every short card. Zero runtime dependencies, 8.6 KB gzipped, +> signal-based, zoneless, SSR-safe. Works on Angular 17.1 through 22. Install with `npm install masonry-angular`. Import `NG_MASONRY_GRID` — an array of all four directives — into a standalone component's `imports`. diff --git a/projects/masonry-angular/README.md b/projects/masonry-angular/README.md index 8dec4f8..4d22fa4 100644 --- a/projects/masonry-angular/README.md +++ b/projects/masonry-angular/README.md @@ -3,6 +3,9 @@ Cascading grid ("masonry") layout for Angular. Its own solver — no `masonry-layout`, no jQuery, no `imagesLoaded`, no runtime dependencies at all. 8.6 KB gzipped. +For photo galleries, and for dashboards of charts and KPI cards — anywhere a CSS Grid leaves empty +space under the short items. + ```html @for (photo of photos(); track photo.id) { diff --git a/projects/masonry-angular/package.json b/projects/masonry-angular/package.json index b9759e8..3030959 100644 --- a/projects/masonry-angular/package.json +++ b/projects/masonry-angular/package.json @@ -14,6 +14,11 @@ "pinterest", "columns", "responsive", + "dashboard", + "dashboard-layout", + "charts", + "widgets", + "cards", "gallery", "image-gallery", "signals", From 834a53ed073f4de20cc1d8cefdc2617e696ffa87 Mon Sep 17 00:00:00 2001 From: Akib Date: Sat, 12 Sep 2026 23:51:52 +0600 Subject: [PATCH 2/2] release: 0.0.2 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Dates the changelog and bumps the package to 0.0.2. The headline is the peer range. 0.0.1 declared ^22.0.0, so npm refused to install it on Angular 17 through 21 — most of the versions the README claims support for. Anyone finding the package through npm search today hits that wall, which makes this release the one that makes it installable at all. Nothing in the runtime changed. The npm README now asks directly for the two things that help: an issue when something breaks, and a star when it doesn't. Stars decide whether the next person with the same layout problem ever finds the package, and an honest ask beats hoping. --- CHANGELOG.md | 5 ++++- README.md | 3 +++ projects/masonry-angular/README.md | 15 ++++++++++----- projects/masonry-angular/package.json | 2 +- 4 files changed, 18 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6fd58c3..627b615 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,9 @@ # Changelog -## Unreleased +## 0.0.2 — 2026-09-12 + +**If you are on Angular 17 to 21, this is the release that lets you install the package at +all.** `0.0.1` declared a peer range of `^22.0.0`, so npm refused it everywhere else. Nothing in the library's runtime changed. The one change that affects installing it is the peer range; everything else is documentation, examples and project setup. diff --git a/README.md b/README.md index 09c2924..0e67130 100644 --- a/README.md +++ b/README.md @@ -70,6 +70,9 @@ understanding the layout engine. [**Ways to help**](CONTRIBUTING.md#ways-to-help) lists what would help most right now. [Opening a pull request](CONTRIBUTING.md#opening-a-pull-request) is three commands and no ceremony. +If it works well for you, a star helps other people find it — search and recommendations both weigh +it. If it doesn't, an issue helps more. + ## License MIT — see [LICENSE](LICENSE). diff --git a/projects/masonry-angular/README.md b/projects/masonry-angular/README.md index 4d22fa4..7894378 100644 --- a/projects/masonry-angular/README.md +++ b/projects/masonry-angular/README.md @@ -134,12 +134,17 @@ Standalone became the default in Angular 19; before that, `imports:` on its own ## Help shape it -This is version 0.0.1 — early enough that your opinion still changes the API. +This is version 0.0.2 — early enough that your opinion still changes the API. -The most useful thing you can do is use it in a real project and -[open an issue](https://github.com/MeAkib/masonry-angular/issues/new/choose) about whatever went -wrong or felt harder than it should. "I expected X and got Y" is a complete bug report; you do not -have to diagnose it. +**Something broke, or felt harder than it should?** +[Open an issue.](https://github.com/MeAkib/masonry-angular/issues/new/choose) "I expected X and got +Y" is a complete bug report — you do not have to diagnose it. This is the single most useful thing +anyone can do for the project right now, and it is worth more to me than any other kind of support. + +**Does it work well for you?** A +[star on GitHub](https://github.com/MeAkib/masonry-angular) is how other people find this. Search +and recommendations both weigh it, so it genuinely decides whether the next person with the same +layout problem ever sees it. Also wanted, and none of it requires touching the library: Safari and Firefox reports, mobile and RTL testing, a screen-reader audit, translations of the getting-started guide, and demo examples diff --git a/projects/masonry-angular/package.json b/projects/masonry-angular/package.json index 3030959..6256234 100644 --- a/projects/masonry-angular/package.json +++ b/projects/masonry-angular/package.json @@ -1,6 +1,6 @@ { "name": "masonry-angular", - "version": "0.0.1", + "version": "0.0.2", "description": "Zero-dependency masonry layout for Angular. Signal-based, zoneless, SSR-safe.", "keywords": [ "angular",