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)

nextjs
Searching Database…

What is this?M3E Canvas lets you sketch Material 3 Expressive screens in the browser, link and tap through them, and turn the whole design into a natural-language prompt for an AI coding tool.
Is this a design tool or does it write the app code itself?It's a browser-based visual sketch tool, not a code generator: it outputs a concise text prompt describing your design, which you then hand to an AI coding tool like Claude Code, Codex, Gemini CLI or Cursor to actually build the app.
How do I start using it?Open the hosted web app and start dragging parts onto a canvas; to run it locally, clone the repo and use the Next.js scripts (npm run dev / npm run build), since the app is just a static Next.js export.
Do I need an API key to use it?No, the core canvas and prompt output need nothing. A key is only needed for the optional AI helper, where you bring your own OpenAI, Claude, Gemini or DeepSeek key to auto-write a part's behavior note or a screen's description.
Does it build the app for me, or just the design?It only produces a prompt and a clickable preview; you still paste the prompt into an AI coding tool and run the generated app yourself. On a phone you also only get a simplified, buttons-only single-screen editor instead of the full multi-screen desktop tool.
Where does my design and any AI key end up?Everything is saved only in your browser's localStorage, and if you use the optional AI helper your key never leaves the browser — requests go straight to the provider with no server in between.
Is it free to use?Yes, it's MIT-licensed and stays free, and no feature is gated behind sponsorship.
What is Material 3 Expressive?It's Google's latest Material Design 3 style, with bouncier shapes, spring-based motion and richer theming, which this tool lets you prototype visually before writing any code.
Can I target the web instead of Android?Yes, when generating the prompt you can pick Android (the default) or the web as the target, and the prompt is written to ask for the matching stack.
How do I share a design with someone else?You can copy a share link that opens your design on anyone else's canvas, or copy an AI-draft instruction so a coding agent reads agent.md, sketches what you described, and replies with such a link.
What happens when I drag two buttons close together?They magnetically fuse into one connected group and their corners soften where they meet, and this grouping is explicitly described in the generated prompt so the layout isn't lost.
Creator
lnkiai
Size
28.6 MB
Stars
9.5K
Updated
CommitOct 16
Age
1mo
Commits · 90 Days