Add launch assets and playbook

Author: bigmacfive

README.ko.md

@@ -52,6 +52,8 @@ appbun https://chat.openai.com --name "ChatGPT" --dmg
 
 이 한 줄로 프로젝트 생성, 의존성 설치, 앱 빌드, macOS DMG 생성, 설치 창 열기까지 이어집니다.
 
+![appbun terminal demo](https://raw.githubusercontent.com/bigmacfive/appbun/main/docs/assets/terminal-demo.gif)
+
 바로 빌드하지 않고 생성된 프로젝트만 받고 싶다면:
 
 ```bash
@@ -160,20 +162,25 @@ bun run build
 ```bash
 bunx playwright install chromium
 bun run showcase:capture
+bun run demo:gif
 ```
 
 이 명령은 다음을 갱신합니다.
 
 - `docs/screenshots/*.png`
 - `docs/assets/social-card.png`
+- `docs/assets/terminal-demo.gif`
 - `docs/showcase/manifest.json`
 
 ## 릴리즈 점검
 
 ```bash
 bun run release:check
+bun run links:check
 ```
 
+런치 준비 체크리스트와 게시용 원고는 [docs/launch/README.md](./docs/launch/README.md), [docs/launch/post-copy.md](./docs/launch/post-copy.md)에 정리해뒀습니다.
+
 ## 기여
 
 기여 기준은 단순합니다. 생성 앱 품질, 패키징 흐름, 문서를 개선하고, 재현 가능한 테스트나 샘플 scaffold로 증명하면 됩니다.

README.md

@@ -52,6 +52,8 @@ appbun https://chat.openai.com --name "ChatGPT" --dmg
 
 That one command can scaffold the project, install dependencies, build the app, create a DMG on macOS, and open the installer window.
 
+![appbun terminal demo](https://raw.githubusercontent.com/bigmacfive/appbun/main/docs/assets/terminal-demo.gif)
+
 If you want the generated project without building immediately:
 
 ```bash
@@ -160,20 +162,25 @@ bun run build
 ```bash
 bunx playwright install chromium
 bun run showcase:capture
+bun run demo:gif
 ```
 
 This updates:
 
 - `docs/screenshots/*.png`
 - `docs/assets/social-card.png`
+- `docs/assets/terminal-demo.gif`
 - `docs/showcase/manifest.json`
 
 ## Release checks
 
 ```bash
 bun run release:check
+bun run links:check
 ```
 
+Launch prep notes and post copy live in [docs/launch/README.md](docs/launch/README.md) and [docs/launch/post-copy.md](docs/launch/post-copy.md).
+
 ## Contributing
 
 The contribution bar is straightforward: improve the generated app quality, packaging flow, or docs, and prove it with a reproducible test or sample scaffold.

docs/assets/terminal-demo.gif

@@ -0,0 +1,136 @@
+# Launch Playbook
+
+This is the execution checklist for launching `appbun` as an open-source project.
+
+## D-3
+
+### 1. Terminal demo GIF
+
+```bash
+bun run demo:gif
+```
+
+Expected output:
+
+- `docs/assets/terminal-demo.gif`
+
+### 2. README refresh check
+
+Confirm these assets render correctly in GitHub preview:
+
+- `docs/assets/social-card.png`
+- `docs/assets/terminal-demo.gif`
+- `docs/screenshots/showcase-grid.png`
+
+## D-2
+
+### 1. Final `npx` verification
+
+```bash
+npx appbun@latest https://example.com --name "Example" --out-dir ./tmp/example-final --yes --quiet
+```
+
+Check:
+
+- package installs from npm without local workspace leakage
+- generated `package.json` exists
+- generated `electrobun.config.ts` exists
+
+### 2. Broken link check
+
+```bash
+bun run links:check
+```
+
+### 3. Manual smoke test
+
+```bash
+appbun https://www.youtube.com --name "YouTube" --dmg
+```
+
+Confirm:
+
+- metadata resolves
+- icon source is valid
+- DMG is created
+- installer opens
+
+## D-1
+
+### Electrobun Discord introduction
+
+Goal: introduce the project before the launch day spike so the first mention is not a cold link drop.
+
+Post this in the relevant showcase or community channel:
+
+> Built a Pake-style CLI on top of Electrobun called `appbun`.
+> It turns a URL into an inspectable desktop app project, pulls site icons, and now has a macOS DMG flow plus showcase assets.
+> Repo: https://github.com/bigmacfive/appbun
+> I’m still tightening generated app polish and would appreciate feedback on the Electrobun-specific pieces.
+
+## D-Day morning
+
+### GeekNews post
+
+Target time: Korea 10:00 AM
+
+Suggested title:
+
+- `appbun - 한 줄 명령으로 웹페이지를 데스크톱 앱으로 바꾸는 Electrobun 기반 CLI`
+
+Suggested summary:
+
+- Pake처럼 URL 하나로 데스크톱 앱을 만들되, 결과물을 블랙박스로 숨기지 않고 Electrobun 프로젝트로 생성
+- 사이트 메타데이터와 favicon, manifest icon을 가져와 앱 아이콘 생성
+- macOS에선 일체감 있는 상단바와 DMG 설치 흐름 제공
+- Windows, Linux도 빌드 가능한 프로젝트 출력
+- 오픈소스이며 기여 환영
+
+## D-Day night
+
+### Show HN post
+
+Target time: Korea 11:00 PM, US Eastern 9:00 AM
+
+Suggested title:
+
+- `Show HN: appbun – turn any webpage into a desktop app with one command`
+
+Opening comment:
+
+> I built `appbun`, a Pake-style CLI for Electrobun.
+> It takes a URL, pulls usable site metadata and icons, generates an inspectable desktop app project, and adds a macOS DMG path instead of stopping at a raw wrapper.
+> 
+> I focused on keeping the generated project editable instead of hiding everything behind a black box.
+> Recent work included better icon filtering, a more native-feeling macOS shell, interactive safety prompts, and a Playwright-based showcase.
+> 
+> Repo: https://github.com/bigmacfive/appbun
+> npm: https://www.npmjs.com/package/appbun
+
+## D+1
+
+### Reddit and X distribution
+
+Use one primary post per platform, then reply with screenshots, GIFs, and examples instead of repeating the same top-level link.
+
+Recommended assets to attach:
+
+- `docs/assets/terminal-demo.gif`
+- `docs/screenshots/showcase-grid.png`
+- `docs/screenshots/google-maps.png`
+- `docs/screenshots/photopea.png`
+
+## D+3
+
+### Fast follow release
+
+Ship a visible improvement quickly after launch.
+
+Good candidates:
+
+- Windows packaging helper
+- custom icon override flag
+- better generated navigation controls
+- domain presets for popular no-login apps
+
+Rule: mention exactly which community feedback got folded into the release.

docs/launch/README.md

@@ -0,0 +1,106 @@
+# Post Copy
+
+## Electrobun Discord
+
+Built a Pake-style CLI on top of Electrobun called `appbun`.
+
+It turns a URL into an inspectable desktop app project instead of hiding the output behind a black box. It pulls site metadata and icons, generates a cleaner shell, and adds a DMG flow on macOS.
+
+Repo: https://github.com/bigmacfive/appbun
+npm: https://www.npmjs.com/package/appbun
+
+If anyone is building remote web-app wrappers with Electrobun, I’d like feedback on the generated project defaults and packaging flow.
+
+## GeekNews
+
+제목:
+
+`appbun - 한 줄 명령으로 웹페이지를 데스크톱 앱으로 바꾸는 Electrobun 기반 CLI`
+
+본문:
+
+`appbun`은 URL 하나를 받아 Electrobun 기반 데스크톱 앱 프로젝트를 생성하는 CLI입니다.
+
+Pake류 도구처럼 빠르게 웹앱을 앱으로 감쌀 수 있지만, 결과물을 블랙박스로 숨기지 않고 수정 가능한 프로젝트로 출력하는 쪽에 초점을 맞췄습니다.
+
+주요 기능:
+
+- 사이트 메타데이터, favicon, manifest icon 기반 아이콘 생성
+- macOS에서 더 일체감 있게 보이는 상단 영역
+- DMG 생성 흐름 포함
+- Windows, Linux도 빌드 가능한 프로젝트 생성
+- interactive safety prompt 지원 (`--yes`로 생략 가능)
+
+오픈소스 저장소:
+https://github.com/bigmacfive/appbun
+
+npm:
+https://www.npmjs.com/package/appbun
+
+## Show HN
+
+Title:
+
+`Show HN: appbun – turn any webpage into a desktop app with one command`
+
+Body:
+
+I built `appbun`, a Pake-style CLI on top of Electrobun.
+
+You give it a URL and it generates an inspectable desktop app project, pulls site metadata and icons, and gives macOS users a DMG path instead of stopping at a raw wrapper.
+
+I wanted the output to stay editable and hackable rather than hiding everything behind a black box.
+
+Recent polish work:
+
+- stronger icon filtering so broken or tiny assets do not get packaged
+- a more native-feeling unified shell on macOS
+- interactive confirmation prompts for destructive or heavyweight steps
+- a Playwright-driven showcase of public no-login web apps
+
+Repo: https://github.com/bigmacfive/appbun
+npm: https://www.npmjs.com/package/appbun
+
+## Reddit
+
+### r/sideproject
+
+Built `appbun`, a CLI that turns a webpage into a desktop app project using Electrobun.
+
+I wanted a Pake-like workflow, but with generated output you can actually inspect and modify. It now pulls icons from site metadata, ships a macOS DMG flow, and includes safety prompts for overwrite/build steps.
+
+Repo: https://github.com/bigmacfive/appbun
+
+### r/opensource
+
+Open-sourced `appbun`, a small CLI that wraps a URL into an Electrobun desktop app project.
+
+It focuses on generated project quality instead of just producing a one-off wrapper. Current work has gone into icon extraction, shell polish, packaging, and launch assets.
+
+Repo: https://github.com/bigmacfive/appbun
+npm: https://www.npmjs.com/package/appbun
+
+## X
+
+### Short post
+
+Launched `appbun`.
+
+A Pake-style CLI for Electrobun that turns any webpage into a desktop app project with one command.
+
+- usable icon extraction
+- native-feeling macOS shell
+- DMG flow
+- public no-login showcase
+
+GitHub: https://github.com/bigmacfive/appbun
+npm: https://www.npmjs.com/package/appbun
+
+### Longer post
+
+Built `appbun`, a Pake-style CLI on top of Electrobun.
+
+You give it a URL and it generates a desktop app project you can inspect, edit, and ship. I focused on better icon extraction, a more native-feeling macOS shell, interactive safety prompts, and a real launch showcase instead of a thin wrapper demo.
+
+GitHub: https://github.com/bigmacfive/appbun
+npm: https://www.npmjs.com/package/appbun

docs/launch/post-copy.md

@@ -26,7 +26,9 @@
     "prepack": "bun run build",
     "prepublishOnly": "bun run build",
     "release:check": "bun run build && npm pack --dry-run",
-    "showcase:capture": "node scripts/capture-showcase.mjs"
+    "showcase:capture": "node scripts/capture-showcase.mjs",
+    "demo:gif": "node scripts/render-terminal-demo.mjs",
+    "links:check": "node scripts/check-readme-links.mjs"
   },
   "keywords": [
     "electrobun",

package.json

@@ -0,0 +1,65 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const files = ['README.md', 'README.ko.md', 'docs/showcase/README.md'];
+const failures = [];
+
+for (const file of files) {
+  const absolute = resolve(process.cwd(), file);
+  const markdown = await readFile(absolute, 'utf8');
+  const matches = [...markdown.matchAll(/!?\[([^\]]*)\]\(([^)]+)\)/g)];
+  for (const match of matches) {
+    const target = match[2];
+    if (!target || target.startsWith('#')) {
+      continue;
+    }
+    if (/^https?:\/\//i.test(target)) {
+      const localMirror = toLocalGitHubRawPath(target);
+      if (localMirror && existsSync(localMirror)) {
+        continue;
+      }
+      const ok = await checkRemote(target);
+      if (!ok) failures.push(`${file}: ${target}`);
+      continue;
+    }
+    const local = resolve(process.cwd(), file, '..', target);
+    if (!existsSync(local)) {
+      failures.push(`${file}: ${target}`);
+    }
+  }
+}
+
+if (failures.length > 0) {
+  console.error('Broken links found:');
+  for (const failure of failures) {
+    console.error(`- ${failure}`);
+  }
+  process.exit(1);
+}
+
+console.log('All checked README links are valid.');
+
+async function checkRemote(url) {
+  for (const method of ['HEAD', 'GET']) {
+    try {
+      const response = await fetch(url, {
+        method,
+        redirect: 'follow',
+        headers: { 'user-agent': 'appbun-link-check/0.5.1' },
+      });
+      if (response.ok) return true;
+    } catch {
+      // ignore and retry with next method
+    }
+  }
+  return false;
+}
+
+function toLocalGitHubRawPath(url) {
+  const match = url.match(/^https?:\/\/raw\.githubusercontent\.com\/bigmacfive\/appbun\/main\/(.+)$/i);
+  if (!match?.[1]) {
+    return undefined;
+  }
+  return resolve(process.cwd(), match[1]);
+}