designcraft README

The project's README from github.com/storytold/designcraft. As one markdown file: README.md.

ArtCraft

DesignCraft

Page layout and publishing; an open-source, clean-room reimplementation of Adobe InDesign, rebuilt in pure Rust.

A fast, open-source, clean-room take on the Adobe InDesign workflow. It runs natively on macOS, Windows and Linux, and in the browser via WebAssembly.
By the ArtCraft team.

Written in Rust Runs on macOS, Windows, Linux and the web License: MIT OR Apache-2.0 Agent-drivable over MCP

Join the ArtCraft community on Discord

DesignCraft on getartcraft.com · ArtCraft · All Crafting Apps


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
Quarterly, Spring Issue: threaded three-column body text, a wrapped pull quote and parent-page folios, all set by DesignCraft's own paragraph composer.

[!NOTE] ArtCraft is a community of artists from all walks of life. Digital, generative, music, games — if you make things, you're one of us. Come say hi on Discord.

The sample magazine · Why DesignCraft · Quick start · Web · Architecture · Downloads · The Crafting Apps · License and credits

The sample magazine

Every page below was laid out by DesignCraft from code (crates/engine/src/sample.rs) and exported by its own renderer. Try it yourself with File → New → Sample Document, or start the app with --sample.

Magazine cover for The Spring Issue, No. 01: a dusk landscape of layered purple hills under a large pale sun, with the white serif headline The Quiet Art of Layout and an italic deck below

Cover. A full-bleed graphic frame, display type and an italic deck.

Feature opener titled Notes on the Grid, with an orange FEATURE · DESIGN kicker over a rule, an italic deck, a wide landscape picture with a small caption, and two columns of justified body text above a QUARTERLY folio

Styles. Kicker rule, headline, deck, caption and justified two-column body.

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

Threading, columns and text wrap. One story flows through three columns and around the pull quote.

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

Swatches. Named colors and a CMYK process swatch, laid out as a palette.

Why DesignCraft

Quick start

The egui frontend requires Rust 1.95 or newer (including its shared craft-ui components).

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 xtask ci                                             # fmt, clippy, tests, assets, layering, wasm

Japanese text (UI and documents) uses fonts from storytold/craft-fonts, an optional build input (font files are never committed here; see craftrules standards/fonts.md):

git clone https://github.com/storytold/craft-fonts ../craft-fonts
CRAFT_FONTS_DIR="$PWD/../craft-fonts" cargo run --release -p designcraft   # absolute path

Without it, Japanese falls back to the system's fonts (none on the web). Release builds always include it.

To drive a running app, send JSON lines to 127.0.0.1:7979. The protocol is described in docs/control-protocol.md.

Logs

The desktop app writes its log records to standard error and to logs/designcraft.log in the settings directory, beside ui.json and prefs.json (Linux ~/.config/designcraft/logs/, or $XDG_CONFIG_HOME/designcraft/logs/; macOS ~/Library/Application Support/DesignCraft/logs/; Windows %APPDATA%\DesignCraft\logs\). A start launched from a desktop menu or the Dock has no terminal, so this file is what to attach to a bug report: the crash guard's panic report and a failed crash-recovery save land there. Each launch moves the previous log to designcraft.1.log (and that one to designcraft.2.log), so the log of a run that crashed survives the next start. The file stops growing at 16 MiB. --version writes no file.

Variable Effect
RUST_LOG Log levels for standard error and the log file. Default: info for DesignCraft's own crates, warn for everything else. env_logger-style directives replace that, e.g. RUST_LOG=debug, RUST_LOG=warn,designcraft_render=trace or RUST_LOG=info,wgpu_core=warn; a directive ending in * covers every target starting with it (designcraft*=debug).
WGPU_BACKEND The graphics backend that composites the window: dx12, vulkan, gl or metal (a comma-separated list lets wgpu choose among them). Default: DirectX 12 on Windows, Vulkan on Linux, Metal on macOS, with OpenGL as the fallback. Setting it also turns off the start-up fallback described below.

The logger is apps/designcraft/src/logging.rs; the web build logs to the browser console instead.

Graphics backend

The canvas is rendered on the CPU; the GPU only composites the interface, through wgpu. A graphics driver that faults takes the process down before any Rust code can catch it, so the backend is chosen before the window exists, and a start that never showed a frame is remembered: gpu.json in the settings directory records the backend being tried until the first frame has been presented. A record left behind means that backend crashed (or the app was killed) at start-up, so the next start tries the next one (DirectX 12, Vulkan, then OpenGL on Windows; Vulkan, then OpenGL on Linux) and says so in the status bar. The list starts over once every backend has failed, or with a new DesignCraft version; delete the file or set WGPU_BACKEND to start afresh. Seen in the wild: on an AMD hybrid-graphics laptop (a Radeon RX 6800M beside an integrated Radeon) the AMD Vulkan driver faulted at the first present, which is why DirectX 12 is the Windows default. The code is apps/designcraft/src/gpu.rs.

Web

cd apps/designcraft-web && trunk build --release          # → dist/web (serve it with any static server)
cd apps/designcraft-web && trunk serve --release          # http://127.0.0.1:8767

You need trunk 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
L0 geom (paths, units & measurement parsing, corner options) · color (CMYK/RGB/Lab, swatches, tints, gradients)
L1 doc (spreads, pages, parents, layers, frames, stories, styles) · fonts (font DB, shaping, outlines)
L2 compose (the text engine)
L3 render (vello_cpu)
L4 tools (pointer events → commands + overlays)
L5 engine (session, history, command registry)
L6 ui-egui (InDesign-style UI, control channel)
L7 apps/designcraft, apps/designcraft-cli, apps/designcraft-web

Downloads

New to DesignCraft? Download it from the DesignCraft page on getartcraft.com. That's the easiest way to install it.

Want a specific build or format? On GitHub, the latest release has every build listed below, and all releases has earlier versions and their notes. <ver> in the file names is the version number, and SHA256SUMS.txt lists a checksum for every file.

Windows

Build Installer Portable
x64 (64-bit Intel/AMD) designcraft-<ver>-windows-x64.msi designcraft-<ver>-windows-x64-portable.zip
arm64 (Snapdragon and other ARM PCs) designcraft-<ver>-windows-arm64.msi designcraft-<ver>-windows-arm64-portable.zip
x86 (32-bit) designcraft-<ver>-windows-x86.msi designcraft-<ver>-windows-x86-portable.zip

Installers and executables are code-signed.

macOS

Build File Notes
App, universal (Apple silicon + Intel) designcraft-<ver>-macos-universal.dmg Signed and notarized
Command-line tool, universal designcraft-cli-<ver>-macos-universal.zip Signed and notarized

Linux

Format x86_64 aarch64 (ARM64) Notes
AppImage designcraft-<ver>-linux-x86_64.AppImage designcraft-<ver>-linux-aarch64.AppImage Runs anywhere; updates itself with AppImageUpdate (.zsync files)
Flatpak designcraft-<ver>-linux-x86_64.flatpak designcraft-<ver>-linux-aarch64.flatpak Sandboxed; flatpak install --user <file>
Debian/Ubuntu designcraft-<ver>-linux-x86_64.deb designcraft-<ver>-linux-aarch64.deb
Fedora/RHEL/openSUSE designcraft-<ver>-linux-x86_64.rpm designcraft-<ver>-linux-aarch64.rpm
Tarball designcraft-<ver>-linux-x86_64.tar.gz designcraft-<ver>-linux-aarch64.tar.gz Unpack anywhere

RISC-V (riscv64): designcraft-<ver>-linux-riscv64.tar.gz only, cross-compiled; needs glibc 2.39+ (Ubuntu 24.04 or newer).

FreeBSD

Build File
x86_64 designcraft-<ver>-freebsd-x86_64.tar.gz

Web (WebAssembly)

Build File Notes
Static site designcraft-web-<ver>.zip Runs in a modern browser; host it on any static server

The Crafting Apps

DesignCraft is one of the Crafting Apps: free, open-source creative tools from the ArtCraft team, each written from scratch in Rust and each able to stand on its own.

App What it's for Code Learn more
PhotoCraft Image editing: layers, masks, type and real PSD files GitHub Website
VectorCraft Vector illustration GitHub Website
FilmCraft Video editing, color and sound GitHub Website
LightCraft Photo library and raw development GitHub Website
PdfCraft Reading, organizing and protecting PDFs GitHub Website
EffectCraft Motion graphics and visual effects GitHub Website
DesignCraft Page layout and publishing · you are here GitHub Website

And ArtCraft itself, our AI image and video studio for artists who want real control.


Join the ArtCraft community on Discord

Come make things with us

Our Discord is where artists of every kind hang out: people who paint, shoot, draw, cut film, set type, and people still figuring out what they like to make. Share what you're working on, ask for help, tell us what's broken, or tell us what you wish these tools could do. Whatever your medium and however long you've been at it, you're welcome here.

discord.gg/artcraft · getartcraft.com · The Crafting Apps · DesignCraft

License and credits

DesignCraft is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 ArtCraft Team and the DesignCraft contributors. Required notices are in NOTICE.

Bundled fonts, icons, images and other assets keep their own open licenses; each one is listed with its author, source and license in ASSETS.md.

The bundled fonts, and the craft-fonts fonts embedded by release builds, are under the SIL Open Font License; all UI icons are drawn in code and are original.

The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as part of this repository and DesignCraft, under docs/brand/LICENSE-brand.txt. Forks and modified versions must remove them.

Adobe, Photoshop, Illustrator, Premiere Pro, Lightroom, Acrobat, After Effects and InDesign are trademarks or registered trademarks of Adobe Inc. in the United States and/or other countries. DesignCraft is an independent, open-source project and is not affiliated with, sponsored by or endorsed by Adobe Inc.; these names are used only to describe the workflows it is compatible with.


ArtCraft
Made by the ArtCraft team and community.

designcraft (storytold/designcraft)

Searching Database…

这是什么?DesignCraft 是 ArtCraft 团队用纯 Rust 编写的开源净室重实现项目,复刻 Adobe InDesign 的页面排版和出版工作流。它可在 macOS、Windows 和 Linux 上原生运行,还能通过 WebAssembly 在浏览器中运行。
这是完成度较高的成品应用,还是仍处于早期阶段?它是一个完整的桌面/网页应用(不是库),以引擎优先的 Cargo workspace 形式构建,带有可替换的 egui UI 层,但项目明确标注为 pre-alpha,并列出了与 InDesign 相比的功能差距清单。
如何安装 DesignCraft?最简单的方法是从 getartcraft.com 的 DesignCraft 页面下载适合你操作系统的构建版本。GitHub Releases 还提供 Windows .msi/便携版、macOS .dmg、Linux AppImage/Flatpak/.deb/.rpm/tar 包、FreeBSD tar 包以及 WebAssembly 静态站点版本。
在依赖它之前我需要了解什么?该项目处于 pre-alpha 阶段,文档中记录了与 InDesign 相比的已知差距(docs/gaps.md)。项目还会主动防范启动时的 GPU 驱动崩溃,因为驱动故障可能在任何 Rust 代码来得及捕获之前就把整个进程拖垮。
这个开源许可证没有任何限制吗,还是有什么附加条件?代码可按你的选择以 MIT 或 Apache-2.0 双许可提供,但 ArtCraft 名称、字标和徽标是单独注册的商标,只能在本仓库内原样使用;分支项目必须移除它们。
运行它需要很强的显卡吗?不需要——画布本身通过 SIMD 在 CPU 上渲染(vellocpu);GPU 只用于通过 wgpu 合成界面,如果某个后端启动失败,会在 DirectX 12、Vulkan、Metal 和 OpenGL 之间自动回退。
DesignCraft 可以导入和导出哪些文件格式?它有自己的有文档说明的原生格式,支持 IDML 导入和导出,并可导出为 PNG、PDF(包括用于印刷和归档的 PDF/X-4 和 PDF/A-2b)以及 EPUB。
像 Claude 这样的 AI 智能体真的能控制这个应用吗?可以——每个菜单项、工具手势、面板控件和对话框都可以通过 JSON 控制通道或 MCP 服务器驱动,让 Claude 和其他智能体像人类设计师一样排版和编辑文档。
它所属的“Crafting Apps”系列是什么?DesignCraft 是 ArtCraft 出品的几款免费开源 Rust 创意应用之一,同系列还有 PhotoCraft、VectorCraft、FilmCraft、LightCraft、PdfCraft 和 EffectCraft,每个都是独立应用,此外还有 ArtCraft 自己的 AI 图像/视频工作室。
它的排版引擎有什么过人之处?它使用带词典断字的 Knuth–Plass 段落排版器,支持光学边距对齐、基线网格和字形缩放两端对齐,并保证屏幕上和导出 PDF 中的换行位置完全一致。
Creator
storytold
Size
22.8 MB
Stars
4.3K
Age
17d
Commits · 90 Days