@vdaluz/astro-og-cards 1.1.1 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# @vdaluz/astro-og-cards
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@vdaluz/astro-og-cards)
|
|
3
4
|
[](https://github.com/vdaluz/astro-og-cards/actions/workflows/ci.yml)
|
|
5
|
+
[](LICENSE)
|
|
4
6
|
|
|
5
7
|
Social shares need an OG image, and generating one at build time from real post data (not a hand-designed static fallback) usually means wiring up a headless browser or a from-scratch Satori setup yourself. `@vdaluz/astro-og-cards` packages both halves: a meta-tag emission component for the `og:*`/`twitter:*` tags, and a build-time card generation harness (satori + sharp) that renders styled HTML to a real PNG. Ships raw `.astro`/`.ts` - the consuming app's Astro/Vite compiles them (no prebuild step), same as `@vdaluz/astro-blog`. Proven in production on [vdaluz.com](https://vdaluz.com) and [imperfectsystems.com](https://imperfectsystems.com).
|
|
6
8
|
|
|
@@ -10,21 +12,6 @@ Social shares need an OG image, and generating one at build time from real post
|
|
|
10
12
|
npm install @vdaluz/astro-og-cards
|
|
11
13
|
```
|
|
12
14
|
|
|
13
|
-
Alternatively, a pinned https tarball from a tag works too, with no registry involved:
|
|
14
|
-
|
|
15
|
-
```jsonc
|
|
16
|
-
// package.json
|
|
17
|
-
"dependencies": {
|
|
18
|
-
"@vdaluz/astro-og-cards": "https://github.com/vdaluz/astro-og-cards/archive/refs/tags/v1.1.0.tar.gz"
|
|
19
|
-
}
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
> **Why a tarball, not `github:vdaluz/astro-og-cards#v1.0.0`?** npm canonicalizes GitHub
|
|
23
|
-
> shorthand (and even an explicit `git+https://` URL) to `git+ssh://` in the lockfile.
|
|
24
|
-
> CI runners (e.g. Cloudflare Pages/Workers) have no SSH key, so `npm ci` would fail to
|
|
25
|
-
> clone it. The `/archive/refs/tags/<tag>.tar.gz` URL is anonymous https with an integrity
|
|
26
|
-
> hash in the lockfile - it just works in CI. Bump the tag in the URL to upgrade.
|
|
27
|
-
|
|
28
15
|
Peer dependency: `astro` >= 6.
|
|
29
16
|
|
|
30
17
|
> **Installing this pulls in native `sharp`.** `satori`, `satori-html`, and `sharp` are regular
|
|
@@ -98,6 +85,14 @@ Bundles a default static (non-variable) font, [Space Mono](https://github.com/go
|
|
|
98
85
|
|
|
99
86
|
Issues welcome. PRs by discussion - open an issue first for anything beyond a typo or docs fix.
|
|
100
87
|
|
|
88
|
+
## Consumers
|
|
89
|
+
|
|
90
|
+
- [vdaluz.com](https://vdaluz.com)
|
|
91
|
+
- [imperfectsystems.com](https://imperfectsystems.com)
|
|
92
|
+
- [freetoolbox.net](https://freetoolbox.net)
|
|
93
|
+
- [wq1k.com](https://wq1k.com)
|
|
94
|
+
- [vicstradamus.com](https://vicstradamus.com) (devDependency, build-time card generation only)
|
|
95
|
+
|
|
101
96
|
## License
|
|
102
97
|
|
|
103
98
|
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vdaluz/astro-og-cards",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.2",
|
|
4
4
|
"description": "Build-time OG/social-card generation (satori + sharp) and meta-tag emission for Astro - proven in production on vdaluz.com and imperfectsystems.com.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"astro",
|