storytold/designcraft

选用指南

AI 根据 README 整理 · 2026/10/17 05:35:51

适用场景

适用于杂志、书籍等页面布局和出版场景，支持多栏文本、样式、图文混排等。

查看 README 依据

<br> <p align="center"> <img src="docs/images/ui-spread.png" alt="DesignCraft showing a magazine spread: a threaded three-column story is selected with its in/out ports and thread line, the Control panel shows its position in picas and the Properties panel its text frame options" width="100%"> <br>_{<b>Quarterly, Spring Issue</b>: threaded three-column body text, a wrapped pull quote and parent-page folios, all set by DesignCraft's own paragraph composer.} </p> > [!NOTE] > **ArtCraft is a community of artists from all walks of life.** Digital, generative, music,

<td width="50%" valign="top"><img src="docs/images/page-3.png" alt="Three-column page of justified, hyphenated body text that wraps around a shaded pull quote reading The best layouts disappear. What remains is the story., with a gradient rule and SPRING ISSUE folio at the foot" width="100%"><p align="center">_{<b>Threading, columns and text wrap.</b> One story flows through three columns and around the pull quote.}</p></td>

目标用户

面向熟悉 Adobe InDesign 的设计师，因为其界面和操作方式与 InDesign 相似。

查看 README 依据

<td width="50%" valign="top"><img src="docs/images/page-4.png" alt="Coming Next page titled Color, Ink and Paper on a plum background, with four swatch circles labeled Ink Plum, Sunset, C=100 M=0 Y=0 K=0 and Paper Warm, above a short paragraph of body text" width="100%"><p align="center">_{<b>Swatches.</b> Named colors and a CMYK process swatch, laid out as a palette.}</p></td> </tr> </table> ## Why DesignCraft - **Familiar.** InDesign's layout, tools, menus, panels and shortcuts: spreads and parent pages,

使用方式

可通过桌面应用、命令行工具或 Web 版本使用，也支持通过 JSON 控制通道和 MCP 服务器由 AI 代理驱动。

查看 README 依据

documents like a designer. See [`docs/control-protocol.md`](docs/control-protocol.md) and [`docs/mcp.md`](docs/mcp.md). - **Everywhere.** One Rust codebase for desktop and the web. ## Quick start The egui frontend requires Rust 1.95 or newer (including its shared `craft-ui` components). ```sh cargo run --release -p designcraft # desktop app (start screen) cargo run --release -p designcraft -- --sample # open the sample magazine cargo run --release -p designcraft -- --sample --control 7979 # + JSON control channel

cargo run --release -p designcraft-cli -- run --sample --all-pages out/ # headless: render every page to PNG cargo run --release -p designcraft-cli -- commands # list every command cargo run --release -p designcraft-cli -- script --help # command script syntax (docs/agents.md) cargo xtask ci # fmt, clippy, tests, assets, layering, wasm ``` Japanese text (UI and documents) uses fonts from [storytold/craft-fonts](https://github.com/storytold/craft-fonts), an optional build input (font files are never committed here; see craftrules

You need [trunk](https://trunkrs.dev) and the `wasm32-unknown-unknown` target. The same app runs through eframe's web runner on WebGPU, falling back to WebGL2 (`?webgl` forces it; `?sample` opens the sample magazine). Open and Place use the browser's file picker, and dropping files works too. Save and Export download the file. The web build has no control channel. ## Architecture DesignCraft is an engine-first Cargo workspace with enforced layering (`cargo xtask layers`). The egui frontend is a separate crate, so the UI can be swapped without touching the engine. | Layer | Crates |

部署要求

桌面版需要 Rust 1.95 或更高版本编译；Web 版需要 trunk 和 wasm32-unknown-unknown 目标。

查看 README 依据

documents like a designer. See [`docs/control-protocol.md`](docs/control-protocol.md) and [`docs/mcp.md`](docs/mcp.md). - **Everywhere.** One Rust codebase for desktop and the web. ## Quick start The egui frontend requires Rust 1.95 or newer (including its shared `craft-ui` components). ```sh cargo run --release -p designcraft # desktop app (start screen) cargo run --release -p designcraft -- --sample # open the sample magazine cargo run --release -p designcraft -- --sample --control 7979 # + JSON control channel

You need [trunk](https://trunkrs.dev) and the `wasm32-unknown-unknown` target. The same app runs through eframe's web runner on WebGPU, falling back to WebGL2 (`?webgl` forces it; `?sample` opens the sample magazine). Open and Place use the browser's file picker, and dropping files works too. Save and Export download the file. The web build has no control channel. ## Architecture DesignCraft is an engine-first Cargo workspace with enforced layering (`cargo xtask layers`). The egui frontend is a separate crate, so the UI can be swapped without touching the engine. | Layer | Crates |

已知限制

项目处于 pre-alpha 阶段，存在已知功能差距，Web 版本没有控制通道。

查看 README 依据

- **Status and milestones:** [ROADMAP.md](ROADMAP.md) (stage: pre-alpha); how close to InDesign: [`docs/target-app-parity.md`](docs/target-app-parity.md); known gaps: [`docs/gaps.md`](docs/gaps.md) - **Contributor and agent rules** (clean-room, asset policy, quality gates): [`AGENTS.md`](AGENTS.md) - **Bundled assets:** every one is listed with its licence in [`ASSETS.md`](ASSETS.md) - **App icon and colour:** a calico cat in a polka-dot scarf on DesignCraft green `#7bb51c`; see [`assets/app-icon/`](assets/app-icon/README.md) ## Downloads

You need [trunk](https://trunkrs.dev) and the `wasm32-unknown-unknown` target. The same app runs through eframe's web runner on WebGPU, falling back to WebGL2 (`?webgl` forces it; `?sample` opens the sample magazine). Open and Place use the browser's file picker, and dropping files works too. Save and Export download the file. The web build has no control channel. ## Architecture DesignCraft is an engine-first Cargo workspace with enforced layering (`cargo xtask layers`). The egui frontend is a separate crate, so the UI can be swapped without touching the engine. | Layer | Crates |