gridcraft README

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

ArtCraft

GridCraft

Spreadsheets and data; an open-source, clean-room reimplementation of Microsoft Excel, rebuilt in pure Rust.

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

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

Join the ArtCraft community on Discord

GridCraft on getartcraft.com · ArtCraft · All Crafting Apps


GridCraft showing a quarterly sales dashboard: a styled table with banded rows, filter buttons, a totals row, data bars, arrow icons and sparklines, next to a clustered column chart and a pie chart
Quarterly Sales Dashboard: a table with a totals row, conditional formatting, sparklines and two live charts — built entirely from GridCraft commands (File → New → Sample).

[!NOTE] ArtCraft is a community of artists from all walks of life. Painters, photographers, filmmakers, illustrators, designers, animators, hobbyists, and people who picked up a pencil last week. If you make things, you're one of us. Come say hi on Discord.

A look around · Why GridCraft · Quick start · For agents · Architecture · Roadmap · The Crafting Apps · License and credits

A look around

A household budget with accounting number formats, red highlights for overspent categories, a green-yellow-red colour scale on the percent-used column, a totals row with a double border, and a horizontal bar chart comparing budget with actual

Formatting. Accounting formats, cell styles, conditional rules and colour scales, frozen headers and a bar chart.

A gradebook table with averages and letter grades computed with IFS, green highlights on A grades and data bars, with the Formulas ribbon tab open showing the function library

Formulas. 500+ functions, dynamic arrays, LET and LAMBDA, structured table references.

The sales dashboard in dark mode with the Insert ribbon tab open, showing PivotTable, Table, Pictures, Shapes, chart, sparkline, link, comment, text box and symbol buttons

Dark mode and the Insert tab: tables, charts, sparklines, pictures, shapes, links and comments.

A PivotTable summarising revenue by region and product with a Channel report filter, grand totals and currency formatting, with the PivotTable Fields pane open on the right showing ticked fields and the Filters, Columns, Rows and Values areas

PivotTables. Field list, filters, layouts, date grouping and show-values-as, saved to and read from XLSX.

The sales dashboard with the column chart selected: resize handles on the chart, its source data outlined in the table, the Chart Design tab open and the Format Chart Area pane on the right

Charts. Seventeen chart types, Chart Design tab and a Format pane; selecting a chart outlines its source data.

The household budget in Page Break Preview: the print area outlined in blue with a dashed page break, Page 1 and Page 2 watermarks, and the area outside the print range greyed out

Page Break Preview, print settings, and PDF export and printing.

Why GridCraft

Quick start

cargo run --release -p gridcraft                              # desktop app
cargo run --release -p gridcraft -- --sample sales            # open a sample (sales, budget, grades)
cargo run --release -p gridcraft -- book.xlsx                 # open a workbook
cargo run --release -p gridcraft -- --sample sales --control 7979   # + JSON control channel
cargo xtask ci                                                 # fmt, clippy, tests, assets, layering, wasm

Choose Español under View → Interface language for Spanish formula names, decimal commas, and semicolon arguments. Workbooks, clipboard exchange, and programmatic APIs retain canonical English syntax.

Web

cd apps/gridcraft-web && trunk build --release     # → dist/web (serve it with any static server)
cd apps/gridcraft-web && trunk serve --release     # http://127.0.0.1:8771  (?sample=sales opens a sample)

You need trunk and the wasm32-unknown-unknown target. Open uses the browser's file picker (dropping files works too) and Save downloads the workbook.

Ribbon access keys

Press and release left Alt on Windows/Linux/BSD, or press F10 on any platform, then type a sequence below one key at a time. Keytips appear on the supported Home controls and menu items. On macOS, use F10 (Fn+F10 if required by your keyboard); Option remains available for entering accented characters.

Sequence after Alt/F10 Action
H A L / H A C / H A R Align left / center / right
H V S or legacy E S Open Paste Special
H O I or legacy O C A AutoFit selected columns

In Paste Special, T/V/F/C select formats/values/formulas/comments, and E toggles Transpose. Enter applies the selected options; Escape cancels the dialog. These letters also work with Alt held on Windows/Linux/BSD.

Escape backs out one keytip level; Alt/F10 again exits keytips. Clicking, scrolling, or switching windows cancels navigation. Access keys do not start while editing text or using another dialog. This is initial support for these Home and legacy paths; other ribbon commands and full mouse-free navigation remain to be implemented. Browsers or desktop environments may reserve Alt/F10 for their own menus.

Logs

The desktop app writes its log to standard error and to gridcraft.log in the logs folder next to its settings: ~/.config/gridcraft/logs on Linux and BSD ($XDG_CONFIG_HOME/gridcraft/logs when set), ~/Library/Application Support/GridCraft/logs on macOS and %APPDATA%\GridCraft\logs on Windows. Each start moves the previous log to gridcraft.1.log and that one to gridcraft.2.log, so the log of a run that crashed survives the next start; attach them to a bug report. A log file stops growing at 16 MiB. By default GridCraft's own crates log at info and everything else at warn; RUST_LOG replaces that with env_logger-style directives, e.g. RUST_LOG=debug or RUST_LOG=warn,gridcraft_engine=debug (a trailing * matches a prefix: gridcraft*=debug). Runs with GRIDCRAFT_NO_PREFS set (no saved settings) log to standard error only.

For agents: MCP, CLI and the control channel

claude mcp add gridcraft -- gridcraft-cli mcp                 # headless MCP server
gridcraft-cli mcp --connect 7979                               # MCP bridged to a running window
gridcraft-cli eval '=XLOOKUP("b",{"a","b"},{1,2})'             # → 2
gridcraft-cli run --sample budget --cmd 'home.bold={"range":"B4:F4"}' --out budget.xlsx
gridcraft-cli cat budget.xlsx --range B4:F15                   # aligned text table
gridcraft-cli commands --search chart                          # every command and its params

The MCP server offers tools such as read_range, write_range, set_cell, evaluate_formula, format_range, insert_chart, create_table, sort_range, filter and execute_command (which reaches every one of GridCraft's commands). The desktop app's control channel adds real pointer and keyboard input, dialogs and screenshots. See docs/mcp.md, docs/cli.md and docs/control-protocol.md.

Architecture

GridCraft 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 core (addresses, values, errors, dates, input parsing) · numfmt (number format codes)
L1 formula (lexer, parser, printer, reference adjustment) · functions (worksheet function library)
L2 model (workbook, sheets, copy-on-write cells, styles, tables, charts…) · calc (dependency graph, evaluator, dynamic arrays) · xlsx (XLSX, CSV, plus XLSB and ODS data import)
L3 chart (toolkit-free chart layout and rendering)
L5 engine (session, commands, history, clipboard, fill, sort, filter, file I/O)
L6 ui-egui (Excel-style UI, control channel) · mcp (MCP server)
L7 apps/gridcraft, apps/gridcraft-cli, apps/gridcraft-web

Roadmap

GridCraft is in alpha: the core workflow works end to end, but depth, fidelity and file compatibility are still rough. It covers 89% of the Excel ribbon commands in our catalog (docs/parity-checklist.md) and 501 of Excel's 523 worksheet functions (docs/function-parity.md); weighted by what Excel users rely on, we estimate it is about 50% ready for real work. Next up: XLSX fidelity on real-world files, very large workbooks and multi-threaded recalc, chart depth, text in every script, and .xls import. Stage, numbers and estimates are in ROADMAP.md; the ranked work list is docs/gaps.md.

Downloads

Download GridCraft from 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) gridcraft-<ver>-windows-x64.msi gridcraft-<ver>-windows-x64-portable.zip
arm64 (Snapdragon and other ARM PCs) gridcraft-<ver>-windows-arm64.msi gridcraft-<ver>-windows-arm64-portable.zip
x86 (32-bit) gridcraft-<ver>-windows-x86.msi gridcraft-<ver>-windows-x86-portable.zip

Installers and executables are code-signed. The MSI installer offers an optional desktop shortcut (unchecked on a new installation).

If the app doesn't open on Windows: the desktop app initializes only DirectX 12 by default. Letting wgpu also create an OpenGL instance can crash some graphics drivers (AMD's atio6axx.dll) before the window appears, so the app would flash in Task Manager and quit. WGPU_BACKEND overrides the default for troubleshooting (for example dx12 or vulkan). In PowerShell, from the folder containing the executable:

$env:WGPU_BACKEND = "vulkan"
& .\gridcraft.exe
Remove-Item Env:WGPU_BACKEND                     # restore the default for later launches

An explicit gl override can bring the driver crash back on affected systems. The macOS, Linux and web backend defaults are unchanged.

macOS

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

Linux

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

FreeBSD

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

Web (WebAssembly)

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

The Crafting Apps

GridCraft 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 GitHub Website
GridCraft Spreadsheets and data · 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 · GridCraft

License and credits

GridCraft is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 ArtCraft Team and the GridCraft 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 ATTRIBUTION.md.

All UI icons are drawn in code and are original; the sample workbooks and every screenshot in this README were made with GridCraft itself. GridCraft bundles no fonts: it uses the fonts installed on your system.

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 GridCraft, under docs/brand/LICENSE-brand.txt. Forks and modified versions must remove them.

Microsoft, Excel and Microsoft 365 are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. GridCraft is an independent, open-source project and is not affiliated with, sponsored by or endorsed by Microsoft Corporation; these names are used only to describe the workflows it is compatible with.


ArtCraft
Made by the ArtCraft team and community.

gridcraft (storytold/gridcraft)

Searching Database…

这是什么?GridCraft 是一个用纯 Rust 构建的开源净室(clean-room)电子表格应用,定位为 Excel 风格的替代品,具备公式、数据透视表、图表和 XLSX 兼容能力。
这是一个库,还是独立应用?它是一个独立的桌面和网页应用(还带有 CLI 和 MCP 服务器),不是用于嵌入其他软件的库。
我怎么让它跑起来?下载适合你平台的预构建版本(Windows 安装程序/便携版、macOS DMG、Linux AppImage/Flatpak/deb/rpm/tarball、FreeBSD tarball 或网页版);网页版则需在安装 wasm32-unknown-unknown target 后用 trunk 运行。
运行网页版之前需要安装什么吗?网页版需要 trunk 构建工具和 wasm32-unknown-unknown Rust target;预构建的原生安装程序无需任何额外内容。
它现在就能替代 Excel 了吗?还不能——它明确处于 pre-alpha 阶段,覆盖了约 89% 的 Excel 功能区/菜单命令和 93% 的工作表函数,按深度加权计算,高级用户依赖的功能大约完成 65%。
它能在哪些平台上运行?它可以在 macOS、Windows、Linux 和 BSD 上原生运行,并通过 WebAssembly 在浏览器中运行。
它会发送使用数据或需要账户吗?没有遥测,也没有许可证服务器——它是一款完全离线、无需订阅的应用。
GridCraft 与真实的 Excel 文件兼容吗?兼容,XLSX 是它的原生格式:样式、主题、公式(包括动态数组)、表格、条件格式、图表、数据透视表和打印设置都能无损往返读写,它还支持 CSV 和 TSV。
AI 智能体怎么控制 GridCraft?每个界面操作都以命令的形式暴露,可通过 MCP 服务器、CLI 或 JSON 控制通道调用,提供 readrange、writerange、setcell 和 insertchart 等工具,桌面应用还支持真实的指针/键盘输入和屏幕截图。
ArtCraft 团队和 Crafting Apps 是什么?ArtCraft 是一个由艺术家和创造者组成的社区,GridCraft 是该团队多款免费开源“Crafting Apps”之一(与 PhotoCraft、VectorCraft、FilmCraft 等并列),每一款都用 Rust 从零重写。
代码库是怎么组织的?GridCraft 是一个“引擎优先”的 Cargo workspace,从 core/formula/functions 到 model/calc/xlsx、chart、engine 再到 egui UI/MCP 层实施强制分层,因此可以在不触及引擎的情况下替换 UI。
Creator
storytold
Size
7.5 MB
Stars
5.6K
Age
11d
Commits · 90 Days