html-anything

agent
Security Audit
Warn
Health Warn
  • License รขโ‚ฌโ€ License: Apache-2.0
  • Description รขโ‚ฌโ€ Repository has a description
  • Active repo รขโ‚ฌโ€ Last push 0 days ago
  • Low visibility รขโ‚ฌโ€ Only 5 GitHub stars
Code Pass
  • Code scan รขโ‚ฌโ€ Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions รขโ‚ฌโ€ No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

โœจ The agentic HTML editor โ€” your local AI agent writes the HTML, you ship it. ๐Ÿš€ 75 Skills ร— 9 Surfaces (magazine ยท deck ยท poster ยท XHS / tweet ยท prototype ยท data report ยท Hyperframes) ๐Ÿ›ก๏ธ Sandboxed preview ยท ๐Ÿ“ค 1-click to WeChat / X / Zhihu / HTML / PNG ๐Ÿ”‘ Zero API key โ€” Claude Code / Cursor / Codex / Gemini / Copilot / OpenCode / Qwen / Aider.

README.md

HTML Anything

Markdown is the draft. HTML is what humans read. Your local agent writes it. The agentic HTML editor โ€” in the agentic era, you don't hand-edit docs anymore, so the output format should be what the reader actually wants: HTML. Local-first, zero API key, reuses the CLI session you already have logged in โ€” 8 coding-agent CLIs auto-detected on your PATH (Claude Code ยท Cursor Agent ยท Codex ยท Gemini CLI ยท GitHub Copilot CLI ยท OpenCode ยท Qwen Coder ยท Aider), driven by 75 composable skill templates across 9 deliverable surfaces (magazine articles ยท keynote decks ยท rรฉsumรฉs ยท posters ยท Xiaohongshu cards ยท tweet cards ยท web prototypes ยท data reports ยท Hyperframes videos). One-click export to WeChat / X / Zhihu, or download .html / .png.

HTML Anything โ€” the agentic HTML editor, on your laptop

License Agents Skills Export Quickstart No API key

Discord (open-design) Follow @nexudotio on X open-design release open-design commits / month Design systems Built on open-design

English ยท ็ฎ€ไฝ“ไธญๆ–‡


Showcase

The eight skills that surface at the top of the picker's Featured / ๆŽจ่ group โ€” sorted by their recommended: rank in SKILL.md frontmatter (lower = higher). Each ships a real example.html you can open straight from the repo, no auth, no setup.

deck-guizang-editorial
deck-guizang-editorial ยท deck ยท recommended: 1
Magazine ร— e-ink editorial deck, inspired by op7418/guizang-ppt-skill โ€” 10 locked layouts ร— 5 palettes (Ink / Indigo Porcelain / Forest Ink / Kraft / Dune). Reads like a printed art-zine, not a slide deck.
deck-swiss-international
deck-swiss-international ยท deck ยท recommended: 2
Swiss International deck โ€” 16-column grid + one saturated accent (Klein Blue / Lemon / Mint / Safety Orange) across 22 locked layouts. Cold, rational, institutional. The deck that reads "a designer made this" the moment it opens.
doc-kami-parchment
doc-kami-parchment ยท doc ยท recommended: 3
Warm-parchment editorial document, inspired by tw93/kami. #f5f4ed ground + ink-blue accent + single serif voice โ€” a noticeably calmer reading surface than plain-white markdown for long essays, reports, and one-pagers.
magazine-poster
magazine-poster ยท poster ยท recommended: 4
Newsprint Sunday-paper poster โ€” oversized serif headline, two-column body, six numbered sections, dot-pattern cream ground. Reads like a printed broadsheet, not a webpage.
video-hyperframes
video-hyperframes ยท frame / video ยท recommended: 5
Hyperframes / Remotion-compatible storyboard โ€” 6โ€“10 sequential 1920ร—1080 frames with hidden duration + transition markers and an auto-play script. Hand straight to heygen-com/hyperframes or Remotion to render .mp4.
frame-glitch-title
frame-glitch-title ยท frame ยท recommended: 6
Glitch title frame โ€” cyan/magenta chromatic offset, CRT scanlines, corrupted-data subtitle, ASCII noise in the corners. Cyberpunk hero card or video transition.
vfx-text-cursor
vfx-text-cursor ยท vfx ยท recommended: 7
VFX text-cursor opener โ€” a cursor "types" across the canvas, each character revealed with a hot-pink ร— cyan chromatic trail and directional light leaks. Drop in a quote, get a film-grade opening frame.
frame-logo-outro
frame-logo-outro ยท frame ยท recommended: 8
Logo outro frame โ€” logo assembles piece-by-piece with glow bloom, tagline rises, CTA appears. The closing card for a product reveal or brand film.

The full skill catalog (organized by mode) is in Skills below.

Why this exists

Anthropic's Claude Code team announced they stopped writing internal docs in Markdown โ€” they ship HTML now. The argument is simple:

Markdown HTML
Good for the writer Good for the reader
Layout limited to the renderer Layout is yours
Looks ugly screenshotted into a tweet Already looks like a designed image
Has to be re-flowed for WeChat / Zhihu / newsletter One-click format conversion

HTML is the final form for humans. Markdown is just an intermediate state during writing.

But "writing HTML" used to mean writing CSS, picking type scales, snapping to a grid, doing responsive โ€” most users won't, designers won't bother, writers don't have the patience. So what we built: after you press โŒ˜+Enter, your local AI agent turns any input (Markdown / CSV / Excel / JSON / SQL / raw notes) into a ship-ready single-file HTML in seconds, then one-click sends it to WeChat / X / Zhihu / anywhere. "Ship-ready" is the bar โ€” when generation finishes, the artifact is what your audience actually sees. No "I'll touch it up later" pass.

We stand on four open-source shoulders:

  • nexu-io/open-design โ€” the agent-detection layer, the design-system model, and the SKILL.md protocol. src/lib/agents/ and src/lib/templates/skills/* mirror this architecture directly.
  • mdnice/markdown-nice โ€” proof that juice-inlined CSS pastes cleanly into WeChat and Zhihu without per-platform manual fix-up.
  • gcui-art/markdown-to-image โ€” the iframe โ†’ high-DPI PNG export path.
  • alchaincyf/huashu-md-html โ€” the anti-AI-slop discipline that maps into the hard constraints inside every SKILL.md (CJK-first font stack, 8 px baseline grid, contrast โ‰ฅ 4.5, must-use-real-data rule).

At a glance

What you get
Coding-agent CLIs (8) Claude Code ยท Cursor Agent ยท OpenAI Codex ยท Gemini CLI ยท GitHub Copilot CLI ยท OpenCode ยท Qwen Coder ยท Aider โ€” scanned on startup across PATH (including ~/.local/bin, ~/.bun/bin, /opt/homebrew/bin, ~/.npm-global/bin โ€” directories a GUI-launched Node process normally misses), swap from the top-bar picker.
Zero API key We reuse the session you already have logged in via claude login ยท cursor login ยท gemini auth. Your existing subscription does the work; marginal cost is $0.
75 skill templates prototype (web / SaaS landing / dashboard / data report) ยท deck (20 keynote skills incl. Swiss International, Guizang Editorial, XHS Pastel, Hermes Cyber, Replit, Magazine Webโ€ฆ) ยท frame (10 Hyperframes video frames โ€” liquid hero, NYT data chart, sticky-note flowchart, glitch title, cinema light-leak, macOS notification, logo outroโ€ฆ) ยท social (X / Xiaohongshu / Spotify / Reddit cards) ยท office (PM spec ยท eng runbook ยท finance report ยท HR onboarding ยท invoice ยท OKRs ยท weekly update ยท meeting notes ยท kanban) ยท doc (Kami warm-parchment editorial) ยท mockup (3D device frame) ยท vfx (text-cursor effect).
9 surface modes ๐Ÿ“– magazine article ยท ๐ŸŽฌ keynote deck ยท ๐Ÿ“„ rรฉsumรฉ ยท ๐Ÿ–ผ๏ธ poster ยท ๐Ÿ“ฑ Xiaohongshu card ยท ๐Ÿฆ tweet card ยท ๐Ÿ› ๏ธ web prototype ยท ๐Ÿ“Š data report ยท ๐ŸŽž๏ธ Hyperframes video. Each has multiple skills you can pick from.
One-click export juice inlines CSS โ†’ WeChat paste with zero re-formatting ยท modern-screenshot renders the iframe to a 2ร— PNG โ†’ ClipboardItem โ†’ drop straight into the tweet composer ยท <mjx-container> โ†’ data-eeimg placeholder โ†’ Zhihu equations render automatically ยท standalone .html download ยท high-DPI .png download.
Streaming render POST /api/convert over SSE. The agent's stdout JSON-line stream is parsed for text deltas โ†’ server-sent events โ†’ client appends โ†’ iframe srcdoc updates live. Waiting for an AI generation looks like watching it type in real time.
Sandboxed preview <iframe sandbox="allow-scripts allow-same-origin">. User-emitted HTML runs in an isolated origin โ€” Tailwind CDN / Google Fonts / inline scripts work, but cookies and localStorage are quarantined from the host.
Format auto-detect The editor accepts Markdown / CSV / TSV / JSON / SQL / plain text. papaparse + xlsx parse tabular data in the browser โ€” nothing is uploaded.
Deployable to Local (pnpm dev) ยท Vercel for the web layer (the agent always stays on your laptop).
License Apache-2.0

Demo

01 ยท Entry view
Entry view โ€” the top bar shows your installed CLIs, the left pane is the editor, the middle is the template + design-system picker, the right is a live iframe preview. The same surface produces magazines, decks, posters, web prototypes, and Hyperframes frame scripts.
02 ยท 75 skills, searchable and filterable
75 templates, searchable and filterable โ€” pick by mode (prototype / deck / frame / social / office / doc) ร— scenario (design / marketing / engineering / product / personal). Every skill ships an example.html you can open straight from the repo to see what the agent will produce.
03 ยท Live SSE streaming
SSE streaming โ€” agent stdout JSON-line is parsed for text deltas, appended into the iframe srcdoc in real time. You watch the page render line by line. Don't like where it's going? Interrupt and re-prompt โ€” no wasted full generation.
04 ยท One-click export
One-click export โ€” WeChat (juice-inlined CSS) ยท X / Weibo / Xiaohongshu (modern-screenshot โ†’ 2ร— PNG โ†’ ClipboardItem) ยท Zhihu (LaTeX image placeholders) ยท download .html ยท download .png. Paste straight in, no second pass of manual formatting.
05 ยท Deck mode
Deck mode โ€” 20 keynote skills, including Swiss International (Helvetica grid maximalism), Guizang Editorial (magazine ink), Open Slide Canvas (1920ร—1080 agent-native), Magazine Web, XHS Pastel, Hermes Cyber, Replit Style. โ†/โ†’ to navigate slides, presenter notes, PDF export.
06 ยท Hyperframes video frames
Hyperframes frames โ€” 10 motion frame scripts (liquid hero, NYT data chart, sticky-note flowchart, glitch title, cinema light-leak, macOS notification, brand logo outro, text-cursor VFX, 3D device mockup, โ€ฆ) conforming to heygen-com/hyperframes; hand off straight to Remotion to render .mp4.

Quickstart

git clone https://github.com/nexu-io/html-anything
cd html-anything
pnpm install
pnpm dev
# โ†’ http://localhost:3000

Open the browser โ†’ the top bar auto-detects whichever coding-agent CLI you already have signed in โ†’ pick a template โ†’ paste content โ†’ โŒ˜+Enter.

No API key required. We reuse the session you already have logged in (Claude / Cursor / Codex / Gemini / Copilot subscriptions all work).

Supported coding agents

On startup we scan PATH (including ~/.local/bin, ~/.bun/bin, /opt/homebrew/bin, ~/.npm-global/bin โ€” directories normally missed by GUI-launched Node) and surface every CLI we recognize:

Agent Detection binary Invocation
Claude Code claude claude -p --output-format stream-json
OpenAI Codex codex codex exec --json --sandbox workspace-write
Cursor Agent cursor-agent cursor-agent --print --output-format stream-json --force --trust
Gemini CLI gemini gemini --output-format stream-json --yolo
GitHub Copilot CLI copilot copilot --allow-all-tools --output-format json
OpenCode opencode-cli / opencode opencode run --format json --dangerously-skip-permissions -
Qwen Coder qwen qwen --yolo -
Aider aider aider --no-pretty --no-stream --yes-always --message-file -

The detection strategy and per-CLI adapter shape are borrowed directly from nexu-io/open-design and multica-ai/multica: one privileged process spawns CLIs, JSON-line is the wire protocol, every CLI gets a thin adapter in src/lib/agents/argv.ts.

If you've already done claude login / cursor login / gemini auth in your terminal, HTML Anything reuses that session. No second copy of the API key required.

Skills

75 skills under src/lib/templates/skills/, each a folder following the Claude Code SKILL.md convention plus an extended frontmatter (mode ยท scenario ยท surface ยท preview ยท design_system).

The two axes the picker uses:

  • mode โ€” prototype (web / SaaS landing / dashboard / data report / rรฉsumรฉ / doc) ยท deck (20 horizontal-swipe presentations) ยท frame (10 Hyperframes motion frames) ยท social (4 social-card formats) ยท office (PM / engineering / finance / HR / operations document surfaces).
  • scenario โ€” design ยท marketing ยท engineering ยท product ยท finance ยท hr ยท sale ยท personal. Used to group skills in the picker.

Web prototypes & marketing pages (prototype mode)

Skill Best for Output
prototype-web Generic web prototype (default) Single-page HTML, 1440ร—900 desktop
saas-landing SaaS landing page Hero / features / pricing / CTA
waitlist-page Waitlist / early-access page Minimal form + social proof
pricing-page Pricing page Multi-tier comparison tables
dashboard Admin / analytics console Sidebar + dense data layout
docs-page Technical documentation 3-column docs layout
blog-post Long-form blog post Editorial layout
mobile-app iOS / Android prototype iPhone 15 Pro chrome
mobile-onboarding App onboarding flow Splash ยท value ยท sign-in trio
gamified-app Gamified app Quest ยท XP ยท level trio
dating-web Dating / matchmaking dashboard Left rail ยท KPIs ยท 30-day chart
magazine-poster Single-page magazine poster 1080ร—1920
poster-hero Marketing poster Single-page display poster
web-proto-editorial Editorial-style web Serif display + grid
web-proto-brutalist Brutalist web Hard edges, black & white, anti-grid
web-proto-soft Soft / warm web Soft shadows, rounded, warm palette
article-magazine Long-form magazine article A4 / long-page
digital-eguide Digital e-guide Cover + lesson spread
resume-modern Minimal rรฉsumรฉ A4 210ร—297mm
email-marketing Brand product-launch email Center single-column, table fallback
wireframe-sketch Hand-drawn wireframe Early-pass ideation

Decks (deck mode, 20 skills)

Skill Best for
deck-swiss-international Swiss International deck
deck-guizang-editorial Editorial-ink deck (from op7418/guizang-ppt-skill)
deck-open-slide-canvas 1920ร—1080 agent-native canvas (from 1weiho/open-slide)
deck-magazine-web Magazine-style web deck
deck-hermes-cyber Hermes Cyber neon-luxe
deck-replit Replit-style product walkthrough
deck-xhs-pastel Xiaohongshu pastel deck
deck-xhs-white Xiaohongshu pure-white deck
deck-xhs-post Xiaohongshu single-post deck
deck-tech-sharing Tech-sharing deck
deck-product-launch Product-launch event deck
deck-pitch Investor pitch
deck-blueprint Blueprint / roadmap
deck-presenter-mode Speaker-notes-aware
deck-course-module Course module deck
deck-dir-key-nav Directional key-nav deep browse
deck-graphify-dark Dark, data-graphic-heavy deck
deck-obsidian-claude Obsidian / Claude-flavored notes
deck-safety-alert Incident / safety briefing
deck-simple Minimal horizontal-swipe deck

Hyperframes video frames & VFX & device mockups (frame / vfx / mockup, 12 skills)

Skill Best for
frame-liquid-bg-hero Liquid background hero
frame-data-chart-nyt NYT-style data chart
frame-flowchart-sticky Sticky-note flowchart
frame-glitch-title Glitch title card
frame-light-leak-cinema Cinema light-leak
frame-macos-notification macOS notification toast
frame-logo-outro Brand logo outro
motion-frames Generic motion-design frame
video-hyperframes Hyperframes frame-script schema
sprite-animation Pixel / 8-bit animation
vfx-text-cursor Text-cursor VFX
mockup-device-3d 3D device-frame mockup

Frame scripts conform to the heygen-com/hyperframes spec and hand off straight to remotion-dev/remotion to render .mp4.

Social share cards (social mode)

Skill Best for
social-x-post-card X / Twitter quote card (1600ร—900)
social-spotify-card Spotify-Wrapped style card
social-reddit-card Reddit thread card
social-carousel 3-card 1080ร—1080 carousel
card-xiaohongshu Xiaohongshu image-with-text card
card-twitter Twitter pull-quote card
social-media-dashboard Social-ops dashboard
social-media-matrix Multi-platform content matrix

Office & operations (office / doc mode)

Skill Scenario Best for
doc-kami-parchment personal Warm-parchment editorial doc (from tw93/kami)
pm-spec product PM spec doc + decision log
team-okrs product OKR scoresheet
meeting-notes operation Meeting decision log
weekly-update operation Team weekly cadence
kanban-board operation Board snapshot
eng-runbook engineering Incident runbook
finance-report finance Exec finance summary
invoice finance Single-page invoice
hr-onboarding hr Role onboarding plan
data-report finance / product CSV/Excel โ†’ visual data report
live-dashboard operation Live data dashboard
flowai-team-dashboard operation Team workflow dashboard
ppt-keynote personal Generic Keynote-style deck

Adding a skill takes one folder. Copy a similar skill, edit its SKILL.md frontmatter, restart pnpm dev, the picker shows it. See CONTRIBUTING.md for the bar a skill PR has to clear before we merge.

Six load-bearing ideas

1 ยท We don't ship an agent. Yours is good enough.

On boot the browser calls /api/agents. The server scans PATH โ€” including the dirs a GUI-launched Node usually misses (~/.local/bin, ~/.bun/bin, /opt/homebrew/bin, ~/.npm-global/bin) โ€” and surfaces whichever CLIs it finds. Each CLI has one adapter (argv + stdin protocol + stream parser) in src/lib/agents/argv.ts. The whole detection model is borrowed directly from nexu-io/open-design and multica-ai/multica: one privileged process spawns CLIs, JSON-line is the wire protocol.

2 ยท Skills are folders, not plugins.

Following Claude Code's SKILL.md convention โ€” SKILL.md + assets/ + references/ + example.html. Drop a folder into src/lib/templates/skills/, restart pnpm dev, the picker shows it. deck-guizang-editorial is vendored directly from op7418/guizang-ppt-skill with original LICENSE and authorship preserved.

3 ยท Hard constraints stop the model from freestyling.

Every template hardcodes:

  • CJK-first font stack โ€” Noto Sans/Serif SC / source-han for Chinese, Inter / Manrope for Latin.
  • 8 px baseline grid โ€” every spacing, line-height, font-size is a multiple of 8.
  • Rounded corners ยท soft shadow ยท no pure black / pure white โ€” visual de-slop-ification.
  • Color contrast โ‰ฅ 4.5, every interactive element has a real :focus state.
  • Must use the user's real data, no lorem ipsum.

The discipline is lifted from alchaincyf/huashu-design's Junior-Designer mode + anti-AI-slop checklist. Constraints belong in the prompt โ€” every SKILL.md writes them in.

4 ยท Streaming render = watch the AI draw.

POST /api/convert is SSE. The agent's stdout is line-delimited JSON; the server pulls out the text deltas and re-emits them as SSE events; the client appends to the iframe's srcdoc. The whole experience is the same as watching the agent type in a terminal, except the artifact is HTML, not Markdown. Interrupt at any time โ€” you're not paying for a whole generation you don't want.

5 ยท One-click export = zero second-pass formatting.

  • WeChat MP โ€” juice inlines CSS + data-tool markers โ†’ paste into the editor, styles survive end to end.
  • X / Weibo / Xiaohongshu โ€” modern-screenshot renders the iframe to a 2ร— PNG โ†’ ClipboardItem โ†’ drop straight into the composer.
  • Zhihu โ€” same as above, plus <mjx-container> is replaced with data-eeimg LaTeX-image placeholders (Zhihu won't render KaTeX live โ€” math has to be an image).
  • Download .html / download .png โ€” self-contained single file, shareable anywhere.

Mechanically inspired by mdnice/markdown-nice and gcui-art/markdown-to-image.

6 ยท Sandboxed iframe = secure + isolated.

User-emitted HTML always renders inside <iframe sandbox="allow-scripts allow-same-origin">. Third-party scripts (Tailwind CDN, Google Fonts, custom animations) still execute, but cookies and localStorage stay in the iframe's own origin โ€” the host page is never poisoned. Opening devtools only shows the iframe's DOM, so the debugging experience matches a standalone HTML file.

Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Browser (Next.js 16) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Editor / upload ยท top-bar agent picker ยท template picker ยท iframe โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
              โ”‚ โŒ˜+Enter                            โ”‚
              โ–ผ                                    โ–ผ
     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
     โ”‚  GET /api/agents    โ”‚            โ”‚  POST /api/convert   โ”‚
     โ”‚  scan PATH, list    โ”‚            โ”‚  SSE โ€” spawn CLI     โ”‚
     โ”‚  installed CLIs     โ”‚            โ”‚  pipe stdin / stdout โ”‚
     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜            โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                                   โ”‚ spawn + stdin pipe
                                                   โ–ผ
                                โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                                โ”‚  Your local coding-agent CLI       โ”‚
                                โ”‚  claude / codex / cursor-agent /   โ”‚
                                โ”‚  gemini / copilot / opencode /     โ”‚
                                โ”‚  qwen / aider                      โ”‚
                                โ”‚  โ†’ reuses your existing session    โ”‚
                                โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                                   โ”‚
                                                   โ–ผ
                                stdout JSON-line โ”€โ”€โ–บ SSE event
                                                   โ”‚
                                                   โ–ผ
                              iframe srcdoc append (live)
                                                   โ”‚
                              โŒ˜+C copy โ†’ ClipboardItem
                              โŒ˜+S download โ†’ .html / .png
Layer Stack
Frontend Next.js 16 App Router + Turbopack ยท React 19 ยท Tailwind v4 ยท zustand state
Server routes GET /api/agents (detection) ยท POST /api/convert (SSE streaming spawn)
Agent transport child_process.spawn ยท one stdin/stdout adapter per CLI (src/lib/agents/argv.ts)
Browser-side processing juice (CSS inlining) ยท modern-screenshot (PNG export) ยท xlsx / papaparse (spreadsheet parsing) ยท marked + highlight.js (Markdown-compatible input) ยท dompurify (XSS defense)
Preview sandbox iframe[sandbox="allow-scripts allow-same-origin"] + srcdoc
Export targets .html standalone ยท .png high-DPI ยท ClipboardItem (text/html + image/png) ยท WeChat-compatible inlined CSS
Deploy Local pnpm dev ยท Vercel one-click for the web layer (agent stays local)

Export targets

Platform Implementation Paste behavior
WeChat MP juice inlines CSS + data-tool markers Paste into editor, zero re-formatting
Zhihu Same as WeChat + <mjx-container> โ†’ data-eeimg LaTeX image placeholder Equations render after upload
X / Weibo / Xiaohongshu modern-screenshot โ†’ 2ร— PNG โ†’ ClipboardItem Drop straight into the composer
Download .html Single-file, inlined assets Open anywhere with a browser
Download .png High-DPI screenshot Share anywhere

Roadmap

  • Multi-template compare preview โ€” generate four candidates of the same brief, pick the best one
  • Hyperframes โ†’ mp4 โ€” one-click hand-off of frame scripts to Remotion for real video output
  • Shared design systems โ€” interop with nexu-io/open-design DESIGN.md assets
  • Template marketplace โ€” community-contributed prompts & examples
  • Browser extension โ€” select on any page โ†’ convert to HTML template
  • History / version diff / IndexedDB archive
  • More export targets โ€” WeChat Channels ยท Douyin captions ยท Notion ยท Linear ยท Telegraph

Status

Early but real. The closed loop โ€” detect agent โ†’ pick skill โ†’ SSE stream โ†’ sandboxed iframe preview โ†’ one-click export โ€” runs end-to-end against all 8 CLIs listed above. The skill library and the SKILL.md hard-constraints are where most of the leverage lives, and both are stable. The picker UX, design-system metadata, and the multi-template compare flow ship daily. If something looks broken on your machine, open an issue with the agent CLI you were using and the input โ€” those are the bug reports that move things forward fastest.

Surface State
Agent detection (8 CLIs) โœ… stable
Skill registry + picker (75 skills) โœ… stable
SSE streaming render โœ… stable
Sandboxed iframe preview โœ… stable
One-click WeChat / X / Zhihu / .html / .png export โœ… stable
CSV / Excel / JSON / SQL format auto-detect โœ… stable
Multi-template compare (generate 4, pick 1) ๐Ÿ›  in progress
Hyperframes โ†’ .mp4 one-click handoff to Remotion ๐Ÿ›  in progress
Browser extension (select on any page โ†’ convert) โณ planned
History / version diff / IndexedDB archive โณ planned
Skill marketplace (install <github-repo>) โณ planned

Contributing

Issues, PRs, new skills, new agent adapters, new export targets, and translations are all welcome. The highest-leverage contributions are usually one folder, one Markdown file, or one PR-sized adapter โ€” small surface area, big leverage. Pick the slot that matches what you want to add:

  • Add a skill โ€” drop a folder into src/lib/templates/skills/ with SKILL.md + example.html (+ optional assets/ and references/). The picker auto-discovers it after pnpm dev restart. The SKILL.md frontmatter has to set mode ยท scenario ยท surface ยท preview ยท design_system โ€” copy a neighbour and edit.
  • Wire up a new coding-agent CLI โ€” one entry in src/lib/agents/argv.ts covering: detection binary, argv builder, stdin/stdout protocol, stream parser. Detection is exercised by src/app/api/agents/ and the spawn loop by src/app/api/convert/.
  • Add an export target โ€” drop a module under src/lib/export/ (next to wechat.ts / image.ts / clipboard.ts) and add the button to the export menu. WeChat Channels ยท Douyin captions ยท Notion ยท Linear ยท Telegraph ยท RSS are all open.
  • Sharpen a SKILL.md โ€” strengthen the hard-constraints (CJK font stack, 8 px baseline, contrast โ‰ฅ 4.5, must-use-real-data), add a 5-dimensional self-critique, swap in a better palette. Anti-AI-slop discipline is the most underrated PR shape we accept.
  • Translations & docs โ€” README.zh-CN.md and CONTRIBUTING.zh-CN.md are kept in parallel with the English files; please update both.

Full walkthrough, bar-for-merging, code style, and what we don't accept โ†’ CONTRIBUTING.md (็ฎ€ไฝ“ไธญๆ–‡).

References & lineage

Every external project this repo borrows from โ€” what we take from each, and where it lands in the tree.

Project Role here
nexu-io/open-design The agent-detection layer, the DESIGN.md design-system schema, and the SKILL.md skill protocol. src/lib/agents/argv.ts and src/lib/templates/skills/ mirror this architecture verbatim.
multica-ai/multica Daemon-and-runtime architecture: one privileged process spawns CLIs, JSON-line is the wire protocol, every CLI gets a thin per-adapter shape.
alchaincyf/huashu-design Anti-AI-slop discipline โ€” Junior-Designer mode, 5-step brand-asset protocol, contrast-โ‰ฅ-4.5 / 8 px baseline-grid / must-use-real-data rules. Hard-coded into every SKILL.md frontmatter.
alchaincyf/huashu-md-html Proof that end-to-end WeChat / Zhihu paste-compatibility is solvable. Reference for src/lib/export/wechat.ts.
mdnice/markdown-nice juice-inlined-CSS pipeline โ†’ WeChat / Zhihu paste with zero re-formatting. Drives src/lib/export/wechat.ts.
mdnice/markdown-resume A4-formatted rรฉsumรฉ inspiration โ†’ resume-modern.
gcui-art/markdown-to-image iframe โ†’ high-DPI PNG export, replicated with modern-screenshot in src/lib/export/image.ts.
op7418/guizang-ppt-skill Magazine-ink editorial deck integrated verbatim as deck-guizang-editorial and the Swiss variant deck-swiss-international. Original LICENSE + authorship preserved.
tw93/kami Warm-parchment monochrome editorial document system โ†’ doc-kami-parchment.
1weiho/open-slide 1920ร—1080 agent-native canvas convention โ†’ deck-open-slide-canvas.
heygen-com/hyperframes Frame-script schema for the entire frame-* / vfx-* / mockup-* / social-* family. Output hands straight off to Remotion to render .mp4.
remotion-dev/remotion Target renderer for Hyperframes frame scripts.
jimliu/baoyu-skills Practical skills collection โ€” reference catalog for picker categorization.

Each bundled upstream skill retains its original LICENSE and authorship inside its own src/lib/templates/skills/<skill>/ folder.

Stay in the loop

Follow @nexudotio on X for release notes, new skills, and the occasional behind-the-scenes thread on what's shipping next. The Discord is where the bigger conversations happen โ€” both are run by the upstream open-design team, and HTML Anything piggybacks on the same channels.

Contributors

Thanks to everyone who has filed an issue, opened a PR, or added a skill / agent adapter / export target. Every real contribution counts, and the wall below is the easiest way to say so out loud.

HTML Anything contributors

If you've shipped your first PR โ€” welcome. The good-first-issue / help-wanted labels are the entry point.

Star History

HTML Anything star history

If the curve bends up, that's the signal we look for. โ˜… this repo to push it.

License

Apache-2.0 ยฉ 2026 HTML Anything contributors. See LICENSE.

Bundled work retains its original license and authorship attribution โ€” see the per-skill LICENSE / README.md inside each src/lib/templates/skills/<skill>/ folder for what it inherits from upstream.

Reviews (0)

No results found