From 8bb9f9534c2f414079179ede772444d416d89dbc Mon Sep 17 00:00:00 2001 From: Brandon Thomas Date: Fri, 9 Oct 2026 13:56:03 -0400 Subject: [PATCH] README in the Crafting Apps style Co-Authored-By: Claude Opus 5.5 --- README.md | 238 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 235 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2f62100..8a93150 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,236 @@ -FigCraft -========== +

+ + + + ArtCraft + + +

-By ArtCraft +

FigCraft

+ +

+ Interface design; an open-source, clean-room reimplementation of Figma, rebuilt in pure Rust.
+ Frames, auto layout, components and variants, vector networks, styles, variables and prototypes,
+ in a native app that opens instantly and works offline. Open source, and yours. +

+ +

+ 100% Rust + macOS · Windows · Linux · FreeBSD · Web + License: MIT OR Apache-2.0 + Status: early alpha +

+ +

+ Join the ArtCraft community on Discord +

+ +

+ FigCraft on getartcraft.com · + ArtCraft · + All Crafting Apps +

+ +
+ +> [!NOTE] +> **ArtCraft is a community of artists from all walks of life.** Designers, illustrators, developers, +> musicians, game makers — if you make things, you're one of us. **[Come say hi on Discord](https://discord.gg/artcraft).** + +

+ Features · + Agents · + Under the hood · + Get started · + Crafting Apps · + Discord +

+ +
+ + + + + + + + +
+

🎛️ Familiar by design

+ The toolbar, layers panel, Design panel, menus and shortcuts sit where your hands expect them. If you know Figma, you already know FigCraft. + 		+

⚡ Native and fast

+ A Rust engine with a persistent document model: edits touch only what changed, so creating a node in a 20,000-node file takes a fraction of a millisecond. No Electron, no web view. + 		+

🔌 Offline and private

+ Your files are plain .figcraft archives on your own disk. No account, no cloud, no telemetry. SVG, PNG, JPG, WebP and PDF in and out. + 		+

🤖 Agent-ready

+ Every menu item, tool and drag is a command, so the same engine runs from the UI, the CLI, a JSON control channel or an MCP server. +
+ +
+ +## Features + + + + + + + + + + + + + + +
+

Layouts that build themselves

+ Auto layout in both directions, with wrap and grid, padding, gaps, alignment, Hug / Fill / Fixed sizing, min and max sizes, absolute positioning, and drag handles for padding and spacing right on the canvas. Constraints and layout grids for everything else. + 		+

Components that scale

+ Main components, instances with overrides that survive edits, component sets with variants, properties, swap instance, detach, reset overrides and go to main component. Local styles and variables (colour, number, string, boolean) with modes. +
+

Vectors without compromise

+ Real vector networks: the Pen and Pencil tools, vector edit mode with bend, split, heal-on-delete and handle mirroring, boolean groups (union, subtract, intersect, exclude), flatten, outline stroke, arrowheads, dashes and per-side strokes. Rectangles with smooth (squircle) corners, polygons, stars and arcs. + 		+

Paints and effects

+ Solid, linear, radial, angular and diamond gradients with on-canvas handles, image fills (fill, fit, crop, tile), multiple fills and strokes, every blend mode, drop and inner shadows, layer and background blur, masks. +
+

Type that sets beautifully

+ Text edited in place on the canvas, mixed styles within a paragraph, auto width and auto height, line height, letter and paragraph spacing, decoration, case and text styles, shaped with HarfRust and the open fonts from craft-fonts plus your system fonts. + 		+

Prototype and hand off

+ Connections, triggers, actions and Smart Animate-style transitions, flows and a presentation view. Inspect mode with measurements, CSS and SVG. Export any layer at any scale to PNG, JPG, WebP, SVG or PDF. +
+ +
+ +## Built for agents + +Every menu item, tool and gesture runs a command from one registry of 270+ commands. The UI, the CLI, the JSON control channel and the MCP server all call the same commands, so anything you can click, a script or an AI agent can do too. + +```sh +# Headless: render and export +figcraft-cli render landing.figcraft -o landing.png --scale 2 +figcraft-cli export landing.figcraft -o out/ --format svg + +# Run a script of commands without a window +figcraft-cli run build-card.json --out card.figcraft + +# Every command, with its parameters +figcraft-cli commands --filter autoLayout + +# Let an agent drive it over MCP (headless, or attached to the running app) +figcraft-cli mcp +figcraft-cli mcp --attach 47800 +``` + +The desktop app also offers a loopback-only control channel (`figcraft --control `) for inspecting UI state, driving tools with pointer and key events, and taking screenshots. See [`docs/control-protocol.md`](docs/control-protocol.md), [`docs/mcp.md`](docs/mcp.md) and [`docs/cli.md`](docs/cli.md). + +## Under the hood + +- **Engine first:** a pure-data document model and a command engine, with a thin, swappable egui UI on top. Layering is checked at build time across the workspace crates (`cargo xtask layers`). +- **Persistent data:** the document lives in an immutable ordered map, so undo snapshots are cheap and layout, component sync and text measurement only revisit what changed. +- **Its own renderer:** tiny-skia on every core for the canvas and exports, with layer blending, effects and masks; booleans from linesweeper, geometry from kurbo, text from skrifa and HarfRust. +- **Runs in the browser:** the whole engine and UI compile to WebAssembly. +- **Never crashes:** no `unwrap`, `expect` or `panic` in shipped code, enforced by clippy; commands run behind a guard so a bug fails one action, not your session. +- **Clean-room:** implemented from public documentation and observed behaviour only. No proprietary code, file formats, icons or images. + +## Get started + +```sh +git clone https://github.com/storytold/figcraft +cd figcraft +cargo run --release -p figcraft # the desktop app +cargo test --workspace # the test suite +cargo xtask ci # fmt, clippy, tests, layering and asset checks +``` + +Fonts for the UI and the Text tool come from [craft-fonts](https://github.com/storytold/craft-fonts), cloned next to this repository (`../craft-fonts`); without it FigCraft falls back to your system fonts. + +```sh +git clone https://github.com/storytold/craft-fonts ../craft-fonts +``` + +For the web build, install [trunk](https://trunkrs.dev/) and run `cargo xtask wasm`. + +New contributors and AI agents: start with [`AGENTS.md`](AGENTS.md), then [`docs/`](docs/). + +Installers for macOS (universal, signed and notarized), Windows (x64, x86 and arm64), Linux (AppImage, `.deb`, `.rpm`, Flatpak and tarball), FreeBSD and the web are attached to each [GitHub release](https://github.com/storytold/figcraft/releases). Maintainers: [`docs/releasing.md`](docs/releasing.md) explains how releases are built, signed and published. + +> [!IMPORTANT] +> **Status:** FigCraft is in early alpha. Most of Figma's editor surface exists in some form, and the main menu is almost fully wired ([`docs/parity.md`](docs/parity.md)), but that measures wiring, not behaviour. Multiplayer, comments, version history, plugins and Dev Mode depth are not there yet. The honest, area-by-area picture is in the [roadmap](ROADMAP.md). Expect rough edges and please file issues, or tell us what broke on [Discord](https://discord.gg/artcraft). + +## The Crafting Apps + +FigCraft is one of the **Crafting Apps**: free, open-source creative tools from the +[ArtCraft](https://getartcraft.com/) team, each written from scratch in Rust and each able to +stand on its own. + +| | App | What it's for | Code | Learn more | +|:-:|---|---|---|---| +| | **FigCraft** | **Interface design, components and prototypes · you are here** | [GitHub](https://github.com/storytold/figcraft) | [Website](https://getartcraft.com/apps/figcraft) | +| | **PhotoCraft** | Image editing | [GitHub](https://github.com/storytold/photocraft) | [Website](https://getartcraft.com/apps/photocraft) | +| | **VectorCraft** | Vector illustration | [GitHub](https://github.com/storytold/vectorcraft) | [Website](https://getartcraft.com/apps/vectorcraft) | +| | **FilmCraft** | Video editing, color and sound | [GitHub](https://github.com/storytold/filmcraft) | [Website](https://getartcraft.com/apps/filmcraft) | +| | **LightCraft** | Photo library and raw development | [GitHub](https://github.com/storytold/lightcraft) | [Website](https://getartcraft.com/apps/lightcraft) | +| | **PdfCraft** | Reading, organizing and protecting PDFs | [GitHub](https://github.com/storytold/pdfcraft) | [Website](https://getartcraft.com/apps/pdfcraft) | +| | **EffectCraft** | Motion graphics and visual effects | [GitHub](https://github.com/storytold/effectcraft) | [Website](https://getartcraft.com/apps/effectcraft) | +| | **DesignCraft** | Page layout and publishing | [GitHub](https://github.com/storytold/designcraft) | [Website](https://getartcraft.com/apps/designcraft) | + +And [**ArtCraft**](https://getartcraft.com/) itself, our AI image and video studio for artists who want real control. + +The Crafting Apps share the same conventions: clean-room and pure Rust, native on macOS, Windows, Linux and FreeBSD, in the browser via WebAssembly, and fully drivable by agents. + +
+ +

+ Join the ArtCraft community on Discord +

+ +

Come make things with us

+ +

+ Our Discord is where people who make things hang out: designers sketching their first app, + developers who just want a button to look right, illustrators, filmmakers, type nerds, and + plenty of people still working out what they like to make. Share what you're building, ask for + help, tell us what's broken or what you wish FigCraft could do. You're welcome here. +

+ +

+ discord.gg/artcraft · + getartcraft.com · + The Crafting Apps · + FigCraft +

+ +--- + +## License and credits + +FigCraft is dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option. +Copyright (c) 2026 ArtCraft Team and the FigCraft contributors. Required notices are in [NOTICE](NOTICE). + +Every icon in FigCraft is drawn in code or made for this project, and bundled fonts, images and other +assets keep their own open licenses; each one is listed with its author, source and license in +[ATTRIBUTION.md](ATTRIBUTION.md). + +The ArtCraft name, wordmark and logos in [`docs/brand/`](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 FigCraft, under [`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt). +Forks and modified versions must remove them. + +Figma is a trademark of Figma, Inc. FigCraft is an independent, open-source project and is not affiliated with, sponsored by or endorsed by Figma, Inc.; the name is used only to describe the workflows FigCraft is compatible with. + +

+ ArtCraft
+ Made by the ArtCraft team and community. +

+ +## Star history + +[![Star History Chart](https://api.star-history.com/svg?repos=storytold/figcraft&type=Date&legend=top-left)](https://www.star-history.com/?repos=storytold%2Ffigcraft&type=date&legend=top-left)