m3e-canvas README

The project's README from github.com/lnkiai/m3e-canvas. As one markdown file: README.md.

M3E Canvas

Sketch Material 3 Expressive screens in the browser, link them, tap through them, and copy a prompt for your AI coding tool.

Live demo Deploy GitHub stars MIT License Sponsor Next.js React Material 3 Expressive No backend

Trendshift: #1 repository of the day

日本語 · 中文 · 한국어 · Open the app

Sketching a recipes app in M3E Canvas, changing its theme, copying the prompt, an AI coding tool building it, and the app running on Android

Sketch a recipes app, retheme it, copy the prompt, hand it to an AI coding tool, and run the result on Android. (mp4)

Works with any AI coding tool that takes a prompt, such as Claude Code, Codex, Gemini CLI or Cursor: copy the prompt, paste it into the tool, and ask for the app.

What it does

Tap-through preview
Preview: tap a part and the linked screen slides in.
Prompt panel
Prompt: the design as a concise brief in the selected language.

Phone version
Phone: one screen, buttons only, edited in a bottom sheet.

Keyboard

Key Action
V / H Select / hand tool (hold Space to pan)
Wheel, Ctrl + wheel Pan, zoom
+ - 0 Zoom in, zoom out, fit
Ctrl+Z / Ctrl+Shift+Z Undo / redo
Ctrl+D Duplicate
Arrows (Shift = 8dp) Nudge
Ctrl + drag Move without snapping (no guides, no 4dp grid)
Delete Delete part or screen
P Preview

Develop

npm install
npm run dev        # http://localhost:3000
npm run build      # static export to ./out

The app is a static Next.js export. To host it under a sub-path (for example a GitHub Pages project site), set NEXT_PUBLIC_BASE_PATH=/your-repo at build time. .github/workflows/deploy.yml does this automatically and publishes out/ to GitHub Pages on every push to main.

Contributing

Bug reports, part requests and pull requests are welcome. CONTRIBUTING.md explains the setup, the conventions (English comments, four languages for every string) and where each kind of change lives. Questions go to Discussions.

Support

M3E Canvas is free and MIT-licensed, and stays that way. If it saves you time, you can sponsor the work on GitHub; it pays for the hours that go into new parts, the prompt, and reviewing contributions. No feature is behind sponsorship.

Thanks to the sponsors who keep this going:

Credits

See also

License

MIT © lnkiai


日本語

Material 3 Expressive の画面をブラウザで組み立てて、画面同士をつなぎ、タップして確かめ、そのまま AI コーディング用のプロンプトにするツールです。

公開版: https://lnkiai.github.io/m3e-canvas/

M3E Canvas でレシピアプリを組み、テーマを変え、プロンプトをコピーして AI コーディングツールに渡し、Android で動かすまで

レシピアプリを組み、テーマを変え、プロンプトをコピーして AI コーディングツールに渡し、できたアプリを Android で動かすまで。(mp4)

Claude Code、Codex、Gemini CLI、Cursor など、プロンプトを受け取れる AI コーディングツールならどれでも使えます。プロンプトをコピーしてツールに貼り、アプリを作ってと頼むだけです。

できること

開発

npm install
npm run dev        # http://localhost:3000
npm run build      # ./out に静的書き出し

静的サイトとして書き出す構成です。サブパス(GitHub Pages のプロジェクトサイトなど)で配信するときはビルド時に NEXT_PUBLIC_BASE_PATH=/リポジトリ名 を指定してください。.github/workflows/deploy.yml が main への push ごとにこれを行い、GitHub Pages に公開します。

貢献

バグ報告、部品のリクエスト、PR を歓迎します。手順と約束事は CONTRIBUTING.md にまとめています。質問は Discussions へどうぞ。

支援

M3E Canvas は無料で MIT ライセンスのまま続けます。時間の節約になったら、GitHub Sponsors で開発を支えてもらえると助かります。新しい部品、プロンプトの調整、貢献のレビューにかかる時間に充てます。支援の有無で使える機能は変わりません。

開発を支えてくださっているスポンサーの方々に感謝します。

ライセンス

MIT © lnkiai


中文

在浏览器中拼装 Material 3 Expressive 界面,把屏幕连起来、点一点试试,然后直接变成给 AI 编程工具的提示词。

在线版本:https://lnkiai.github.io/m3e-canvas/

在 M3E Canvas 中拼装食谱应用、更换主题、复制提示词、交给 AI 编程工具构建,最后在 Android 上运行

拼装一个食谱应用、更换主题、复制提示词、交给 AI 编程工具,然后在 Android 上运行成品。(mp4)

可配合任何接受提示词的 AI 编程工具使用,例如 Claude Code、Codex、Gemini CLI 或 Cursor:复制提示词,粘贴到工具里,让它把应用做出来。

功能

m3e-canvas (lnkiai/m3e-canvas)

Searching Database…

这是什么?M3E Canvas 让你在浏览器里绘制 Material 3 Expressive 界面,可以把界面之间连接起来并点击切换,还能把整个设计转换成一段自然语言提示词,交给 AI 编程工具使用。
这是设计工具,还是会直接生成应用代码?它是一个基于浏览器的可视化草图工具,不是代码生成器:它输出一段简洁的文字提示词来描述你的设计,然后你把它交给 Claude Code、Codex、Gemini CLI 或 Cursor 等 AI 编程工具,由它们真正构建应用。
我该怎么开始使用?打开托管的网页应用,把组件拖到画布上即可开始;如果要在本地运行,克隆代码仓库并使用 Next.js 脚本(npm run dev / npm run build),因为该应用只是一个静态的 Next.js 导出产物。
使用它需要 API 密钥吗?不需要,核心画布和提示词输出都不需要任何密钥。只有可选的 AI 助手需要密钥,你需要自备 OpenAI、Claude、Gemini 或 DeepSeek 的密钥,用来自动撰写组件的行为说明或界面的描述。
它会帮我构建应用,还是只做设计?它只生成提示词和可点击的预览;你仍需要把提示词粘贴到 AI 编程工具中,并自己运行生成的应用。在手机上,你还只能使用简化的、仅含按钮的单屏编辑器,而不是完整的多屏桌面版工具。
我的设计和 AI 密钥会存到哪里?所有内容只保存在你浏览器的 localStorage 中;如果你使用可选的 AI 助手,你的密钥永远不会离开浏览器,请求会直接发送给服务提供方,中间没有任何服务器。
使用它免费吗?免费。它采用 MIT 许可证,将保持免费,且没有任何功能需要通过赞助才能使用。
什么是 Material 3 Expressive?它是 Google 最新的 Material Design 3 风格,带有更有弹性的形状、基于弹簧的动效和更丰富的主题配色。借助这个工具,你可以在编写任何代码之前先直观地制作原型。
我可以面向网页而不是 Android 吗?可以。生成提示词时,你可以选择 Android(默认)或网页作为目标平台,提示词会相应地要求使用对应的技术栈。
如何与他人分享设计?你可以复制一个分享链接,打开后会在任何人的画布上显示你的设计;也可以复制一段 AI 草稿指令,让编程代理读取 agent.md、绘制你描述的内容,并回复一个这样的链接。
把两个按钮拖得很近会怎样?它们会磁性地吸附融合成一个相连的组,交接处的边角会变得柔和;这种分组会明确写入生成的提示词中,以免丢失布局。
Creator
lnkiai
Size
28.6 MB
Stars
9.5K
Updated
CommitOct 16
Age
1mo
Commits · 90 Days