Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(marketing): build a paste-ready posting kit for the weekly report, with a formatted HTML article, numbered images, and a checklist

nirholas7d2de96612ae
diff --git a/.gitignore b/.gitignore
index ab08446e5..52e3f6ea7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -493,3 +493,9 @@ packages/node-operator/models/
# Scratch capture of an `npm test` run (.npmtest-<label>.log).
.npmtest-*.log
+
+# weekly report posting kits: regenerated by scripts/build-weekly-report-kit.mjs
+marketing/weekly-report-*/kit/*.zip
+marketing/weekly-report-*/kit/images/
+marketing/weekly-report-*/kit/*.png
+marketing/weekly-report-*/kit/*.html
diff --git a/marketing/weekly-report-1/kit/IMAGE-ORDER.md b/marketing/weekly-report-1/kit/IMAGE-ORDER.md
new file mode 100644
index 000000000..ff5a40c1e
--- /dev/null
+++ b/marketing/weekly-report-1/kit/IMAGE-ORDER.md
@@ -0,0 +1,33 @@
+# Image insertion order
+
+Numbers match the placeholders in weekly-report-1.html. Cover image is separate (cover-x-article.png).
+
+01. 01-home.png
+02. 02-three-token.png
+03. 03-play.png
+04. 04-forge.png
+05. 05-oracle.png
+06. 06-agora.png
+07. 07-vaults.png
+08. 08-labor-market.png
+09. 09-x402-revenue.png
+10. 10-pulse.png
+11. 11-markets.png
+12. 12-markets-news.png
+13. 13-markets-archive.png
+14. 14-ar-studio.png
+15. 15-character-library.png
+16. 16-motion-swap.png
+17. 17-wardrobe.png
+18. 18-sign-language.png
+19. 19-objects.png
+20. 20-nvidia.png
+21. 21-walkthroughs.png
+22. 22-mcp-tools.png
+23. 23-play-war.png
+24. 24-arena.png
+25. 25-reputation-market.png
+26. 26-partners.png
+27. 27-gallery.png
+28. 28-github-100-stars-x.png
+29. 29-github-100-stars-ecosystem.png
diff --git a/marketing/weekly-report-1/kit/POSTING-CHECKLIST.md b/marketing/weekly-report-1/kit/POSTING-CHECKLIST.md
new file mode 100644
index 000000000..aa903bed6
--- /dev/null
+++ b/marketing/weekly-report-1/kit/POSTING-CHECKLIST.md
@@ -0,0 +1,58 @@
+# Weekly Report #1: posting checklist
+
+Everything in this folder is what you need. Rebuild it anytime with `node scripts/build-weekly-report-kit.mjs 1`.
+
+## 1. The X Article
+
+1. Open weekly-report-1.html in a browser. Select all, copy, paste into the X Article editor. Headings, bold, and lists carry over.
+2. Title: `three.ws Weekly Report #1: Everything We Have Shipped So Far`
+3. Cover image: cover-x-article.png (2400x1200).
+4. Replace each grey `[ insert image NN: name ]` placeholder with the matching file from images/ (numbered 01 to 29, see IMAGE-ORDER.md). Delete the placeholder line after inserting.
+5. Suggested captions are in ../README.md; keep them short or skip them.
+6. Publish, copy the article URL.
+
+## 2. The announcing post (@trythreews)
+
+Attach announce-post-16x9.png, then paste the article URL at the end.
+
+Long form (325 characters, needs Premium):
+
+```
+Weekly Report #1 is out, and because it is the first one it covers everything: 19 weeks, week by week, from the first commit to today.
+
+9,508 commits. 21 contributors. 2,674 changelog entries. 725 pages. 101 npm packages. 72 MCP servers. 4,519 x402 endpoints. 110,416 on-chain settlements.
+
+One token: $THREE.
+
+Read it here:
+```
+
+Under 280 characters, if needed:
+
+```
+Weekly Report #1 is out. The first one covers all 19 weeks since the first commit.
+
+9,508 commits. 2,674 changelog entries. 725 pages. 101 npm packages. 72 MCP servers. 4,519 x402 endpoints. 110,416 on-chain settlements.
+
+One token: $THREE. Read it here:
+```
+
+Replies 1 to 3 are in ../../../docs/x-posts/weekly-report-1.md; post them under the main post in order.
+
+## 3. Telegram (@three_ws)
+
+Attach cover-x-article.png, then the article URL:
+
+```
+Weekly Report #1 is out. The first one covers all 19 weeks since the first commit: 9,508 commits, 2,674 changelog entries, 725 pages, 101 npm packages, 72 MCP servers, 4,519 x402 endpoints, every partnership, and where $THREE sits in all of it. Read it here:
+```
+
+## 4. The 100-stars post
+
+Separate post, can go the same day or the day after. Copy and images: ../../../docs/x-posts/github-100-stars.md (images 28 and 29 in this kit are the same graphics).
+
+## 5. Before you post
+
+- `git push threews main` first, so /docs/weekly-report-1 and /docs/three-thesis resolve on the site (the article links to both).
+- The live $THREE figures in the article (16,264 holders, about $2.3M cap, about $538K volume) were read on 2026-08-25. If you post on a later day, update that one bullet from three.ws/three-token.
+- Nothing in the article names another crypto project; safe under the commit gate as-is.
diff --git a/scripts/build-weekly-report-kit.mjs b/scripts/build-weekly-report-kit.mjs
new file mode 100644
index 000000000..89e6a56cf
--- /dev/null
+++ b/scripts/build-weekly-report-kit.mjs
@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// Builds the posting kit for a weekly report: a formatted HTML copy of the
+// article (paste from a browser into the X Article editor), a numbered image
+// manifest, and one zip holding every image in insertion order.
+// node scripts/build-weekly-report-kit.mjs [issue=1]
+import { marked } from 'marked';
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const issue = process.argv[2] || '1';
+const md = readFileSync(resolve(root, `docs/weekly-report-${issue}.md`), 'utf8');
+const kitDir = resolve(root, `marketing/weekly-report-${issue}/kit`);
+const imgDir = resolve(kitDir, 'images');
+mkdirSync(imgDir, { recursive: true });
+
+const sources = [resolve(root, `marketing/weekly-report-${issue}/images`), resolve(root, 'docs/media')];
+const order = [];
+let n = 0;
+const body = md.replace(/^\[IMAGE: ([^\]]+)\]$/gm, (_, file) => {
+ n += 1;
+ const src = sources.map((d) => resolve(d, file)).find((p) => existsSync(p));
+ const out = `${String(n).padStart(2, '0')}-${file}`;
+ if (src) copyFileSync(src, resolve(imgDir, out));
+ order.push({ n, file: out, found: Boolean(src) });
+ return `<p class="img"><em>[ insert image ${String(n).padStart(2, '0')}: ${file} ]</em></p>`;
+});
+
+const html = `<!doctype html><html><head><meta charset="utf-8"><title>Weekly Report #${issue}</title>
+<style>body{max-width:760px;margin:40px auto;padding:0 20px;font-family:Inter,system-ui,sans-serif;line-height:1.55;color:#111}h1{font-size:2rem}h2{margin-top:2.2em}hr{border:0;border-top:1px solid #ddd;margin:2em 0}.img{background:#f4f4f4;padding:8px 12px;border-radius:6px}li{margin:.25em 0}</style>
+</head><body>${marked.parse(body)}</body></html>`;
+writeFileSync(resolve(kitDir, `weekly-report-${issue}.html`), html);
+
+const manifest = ['# Image insertion order', '', 'Numbers match the placeholders in weekly-report-' + issue + '.html. Cover image is separate (cover-x-article.png).', '']
+ .concat(order.map((o) => `${String(o.n).padStart(2, '0')}. ${o.file}${o.found ? '' : ' (MISSING)'}`)).join('\n') + '\n';
+writeFileSync(resolve(kitDir, 'IMAGE-ORDER.md'), manifest);
+
+for (const [from, to] of [
+ [`marketing/weekly-report-${issue}/images/header-x-article.png`, 'cover-x-article.png'],
+ [`marketing/weekly-report-${issue}/images/header-16x9.png`, 'announce-post-16x9.png'],
+]) if (existsSync(resolve(root, from))) copyFileSync(resolve(root, from), resolve(kitDir, to));
+
+execFileSync('zip', ['-qr', `weekly-report-${issue}-kit.zip`, '.'], { cwd: kitDir });
+console.log(`kit: ${kitDir}`);
+console.log(`images: ${order.length} (${order.filter((o) => !o.found).length} missing)`);