Skip to content

Feat/example viewer - #7

Merged
MeAkib merged 2 commits into
mainfrom
feat/example-viewer
Sep 14, 2026
Merged

MeAkib merged 2 commits into
mainfrom
feat/example-viewer

Conversation

@MeAkib

@MeAkib MeAkib commented Sep 14, 2026

Copy link
Copy Markdown
Owner

No description provided.

The demo site linked nowhere. Someone who likes what they see there had no way
to reach the package or the source without going back to wherever they came
from — which is the one moment they are most likely to install it.

The masthead now carries npm, GitHub and StackBlitz links plus the install
command. The workspace readme gets the same three links and a version badge.

The library's own package.json already declared repository, homepage and bugs,
so the npm page sidebar was fine; this is about the two places a visitor
actually lands.
Pasting the demo URL into LinkedIn or Discord showed nothing — no title, no
description, no image. The page had a <title> of "Demo" and no Open Graph tags
at all, so there was nothing for a scraper to read.

Adds the full set: description, og:type/url/title/description/image with
dimensions and alt text, twitter:card as summary_large_image, and a canonical
link. Plus a 1200x630 preview image.

og:image has to be an absolute URL — a relative one is ignored silently, which
is the same failure as having no tag. The deployed origin is not known until
deploy time, so the source carries a __SITE_URL__ placeholder and a postbuild
step fills it in from VERCEL_PROJECT_PRODUCTION_URL, which Vercel documents as
always set, even on previews, precisely so OG image URLs can point at
production. Builds outside Vercel fall back to the default domain.

The script exits non-zero if it finds no placeholders, so the tags going
missing fails the build rather than quietly shipping an unpreviewable page.

Verified: 5 placeholders replaced, absolute URLs in the built HTML, og.png
served at the site root at 1200x630, and the substitution re-checked with the
Vercel variable set.
@vercel

vercel Bot commented Sep 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
masonry-angular Ready Ready Preview Sep 14, 2026 4:37am UTC
masonry-angular-examples Ready Ready Preview Sep 14, 2026 4:37am UTC

@MeAkib
MeAkib merged commit 4a70471 into main Sep 14, 2026
8 checks passed

This branch was successfully deployed

2 active deployments
Preview – masonry-angular 4ef44e97 Deployed Sep 14, 2026 by vercel[bot]
Preview – masonry-angular-examples 4ef44e97 Deployed Sep 14, 2026 by vercel[bot]
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