menloapp 1.5.0 → 1.5.1

package/README.md

@@ -38,6 +38,7 @@ listing yours:
   "githubRepo": "https://github.com/your-name/your-app",
   "menloLink": "https://menloapp.lol/your-app",
   "icon": "menloapp/icon.png",
+  "ogImage": null,
   "screenshots": [
     "menloapp/screenshot-1.png",
     "menloapp/screenshot-2.png",
@@ -64,6 +65,13 @@ The public page reads metadata and media from your Git commit. Media must be
 ordinary files inside `menloapp/`, not symbolic links or Git LFS pointers.
 Only selected files are served. Updates can take up to 60 seconds to appear.
 
+Shared links include a 1200 × 630 image with your app icon, title, description,
+and `menloapp.lol/your-app`. To use your own artwork, set
+`"ogImage": "menloapp/share.png"` (PNG or JPEG, up to 10 MiB; 1200 × 630
+recommended), then commit and push the image and `app.json`. Leave `ogImage`
+absent or `null` for the automatic card. Use menloapp 1.5.1 or later when
+deploying metadata with this field. Social networks may cache older previews.
+
 ## Automatic previews
 
 Deploy can build the committed app in a fresh iPhone Simulator, have Codex

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "menloapp",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "MENLO: share living iOS apps from GitHub and try them on your own iPhone",
   "type": "module",
   "bin": {

package/src/constants.js

@@ -1,4 +1,4 @@
-export const NPM_CLI_VERSION = "1.5.0";
+export const NPM_CLI_VERSION = "1.5.1";
 export const PRODUCT_VERSION = "1.3.0";
 export const MANIFEST_URL = "https://tohseno.com/releases/cli-1.3.0.json";
 export const MANIFEST_ORIGINS = new Set(["https://tohseno.com"]);

package/src/presentation.js

@@ -29,7 +29,7 @@ function publicURL(value, field) {
 /** Public presentation is deliberately small; build and identity are derived elsewhere. */
 export function validatePresentation(value) {
   if (!value || typeof value !== "object" || Array.isArray(value) || value.version !== 1) throw new Error("menloapp/app.json requires version: 1.");
-  for (const key of Object.keys(value)) if (!["version", "name", "subtitle", "description", "icon", "screenshots", "preview", "tokenAddress", "website", "menloLink", "githubRepo"].includes(key)) throw new Error(`Unknown menloapp/app.json field: ${key}`);
+  for (const key of Object.keys(value)) if (!["version", "name", "subtitle", "description", "icon", "ogImage", "screenshots", "preview", "tokenAddress", "website", "menloLink", "githubRepo"].includes(key)) throw new Error(`Unknown menloapp/app.json field: ${key}`);
   const name = text(value.name, "name", 100, true);
   const subtitle = text(value.subtitle ?? "", "subtitle", 160);
   const description = text(value.description ?? "", "description", 4000);
@@ -41,6 +41,7 @@ export function validatePresentation(value) {
   const tokenAddress = value.tokenAddress == null || value.tokenAddress === "" ? null : value.tokenAddress;
   if (tokenAddress !== null && (typeof tokenAddress !== "string" || !/^eip155:[1-9][0-9]{0,31}\/erc20:0x[a-fA-F0-9]{40}$/.test(tokenAddress))) throw new Error("tokenAddress must be a CAIP-19 ERC-20 identifier: eip155:CHAIN_ID/erc20:0x followed by 40 hex characters.");
   const icon = value.icon == null ? null : mediaPath(value.icon);
+  const ogImage = value.ogImage == null ? null : mediaPath(value.ogImage);
   const screenshots = value.screenshots ?? [];
   if (!Array.isArray(screenshots) || screenshots.length > 3 || new Set(screenshots).size !== screenshots.length) throw new Error("Choose up to three distinct screenshots in menloapp/app.json.");
   let preview = null;
@@ -50,11 +51,11 @@ export function validatePresentation(value) {
     if (item.source_commit != null && !/^[a-f0-9]{40}$/.test(item.source_commit)) throw new Error("Preview source_commit must be a full Git commit.");
     preview = { path: mediaPath(item.path, true), kind: item.kind, ...(item.source_commit ? { source_commit: item.source_commit } : {}) };
   }
-  return { version: 1, name, subtitle, description, website, tokenAddress, githubRepo, menloLink, icon, screenshots: screenshots.map(item => mediaPath(item)), preview };
+  return { version: 1, name, subtitle, description, website, tokenAddress, githubRepo, menloLink, icon, ogImage, screenshots: screenshots.map(item => mediaPath(item)), preview };
 }
 
 export function presentationFiles(value) {
-  return [...(value.icon ? [value.icon] : []), ...value.screenshots, ...(value.preview ? [value.preview.path] : [])];
+  return [...new Set([...(value.icon ? [value.icon] : []), ...(value.ogImage ? [value.ogImage] : []), ...value.screenshots, ...(value.preview ? [value.preview.path] : [])])];
 }
 
 export function mediaType(file) {

package/src/project-presentation.js

@@ -19,6 +19,9 @@ export async function setupPresentation(root, name = path.basename(root)) {
 
 Edit app.json and run menloapp deploy from your app's repository.
 Name, subtitle, description, icon and screenshots appear on your public page.
+Shared links get a card with the app icon, title, description and MENLO URL.
+Set ogImage to a PNG/JPEG path such as menloapp/share.png for custom share artwork
+(1200 x 630 recommended), or leave it null to use the automatic card.
 website and tokenAddress are optional. An ERC-20 token uses CAIP-19:
 eip155:CHAIN_ID/erc20:0x followed by the token's 40 hex address characters.
 MENLO fills githubRepo and menloLink automatically when you deploy.