ExcalidrawZ README

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

ExcalidrawZ logo

A native Excalidraw client for macOS, iPadOS, and iOS. Powered by SwiftUI.

GitHub Twitter Discord

Donation to Chocoford

Excalidraw is an excellent drawing tool. ExcalidrawZ keeps the familiar Excalidraw canvas, then adds native file management, iCloud sync, history, export, AI assistance, MCP integration, and Apple-platform interaction details around it.

Download

Download Link - App Store

Non-App Store version

  1. Download the latest .dmg from Releases.
  2. Open the .dmg and drag ExcalidrawZ into Applications.

Preview

App overview

Features

Native File Management

ExcalidrawZ manages drawings as real app documents instead of loose browser downloads.

File History

ExcalidrawZ records checkpoints for app-managed drawings, so you can review earlier versions and restore important work when needed.

File History

Excalidraw Editing, Native Controls

The canvas remains compatible with Excalidraw while the surrounding app is built for Apple platforms.

Collaboration

Use Excalidraw collaboration when you want to draw with others.

Collaboration

AI Drawing Assistant

ExcalidrawZ includes an AI assistant designed for canvas work.

ai_chat

MCP Services

ExcalidrawZ can expose the current app as an MCP server for compatible AI clients.

MCP

Math and Diagram Tools

ExcalidrawZ includes richer tools for technical drawings and study notes.

Math&Diagram

Locked Files and AI Visibility

For sensitive drawings, ExcalidrawZ adds protection around both storage and AI access.

file_lock

Share, Export, and Backup

ExcalidrawZ supports common export and sharing workflows.

Export editable image

Supported Formats

ExcalidrawZ can open, import, edit, or export common Excalidraw-related formats:

Contact

Welcome to my Discord server to share suggestions or report issues for ExcalidrawZ.

Development Guide

Signing configuration

Create Config/Overrides.xcconfig relative to the repository root, alongside Config/Project.xcconfig:

DEVELOPMENT_TEAM = YOUR_TEAM_ID
ICLOUD_CONTAINER = iCloud.com.yourname.ExcalidrawZ
APP_GROUP_IDENTIFIER = group.com.yourname.ExcalidrawZ

Replace these example values with identifiers registered to your Apple Developer team. The shared configuration leaves DEVELOPMENT_TEAM empty; set your team in the local overrides. The app and QuickLook extension must use the same App Group. All targets, including the extension and tests, inherit the team from Config/Project.xcconfig, which includes your local overrides. These overrides apply to all build configurations.

Runtime configuration

Create Config/Secrets.plist relative to the repository root. The project already references this file and includes it in both app targets' resources. The app's configuration loader stops with Unable to load Secrets.plist if the file is missing or invalid.

For local drawing development, this minimal configuration is sufficient:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>COLLAB_URL</key>
    <string>https://example.com</string>
</dict>
</plist>

COLLAB_URL must be a valid absolute URL. The example URL is a placeholder for local drawing work; to test collaboration, replace it with the URL of your deployed collaboration-enabled Excalidraw web client.

Optional string keys are ONEDRIVE_CLIENT_ID, GOOGLE_DRIVE_MACOS_CLIENT_ID, and GOOGLE_DRIVE_IOS_CLIENT_ID. Configure your own OAuth client IDs when developing the corresponding integrations.

Config/Overrides.xcconfig and Config/Secrets.plist are ignored by Git and should stay local.

ExcalidrawZ (chocoford/ExcalidrawZ)

Searching Database…

What is this?A native Excalidraw client for macOS, iPadOS and iOS, built with SwiftUI. It keeps the familiar Excalidraw canvas and adds native file management, iCloud sync, file history, export and AI assistance.
Is it a web app or a desktop app?It is a native app, not a web page. The canvas stays compatible with Excalidraw, but the app around it is built for Apple devices.
How do I install it on my Mac?Download the latest .dmg from the Releases page, open it and drag ExcalidrawZ into Applications. This is the non-App Store version.
Does collaboration work out of the box?Not from a source build by default. The example COLLABURL is a placeholder, so for real collaboration you need the URL of your own deployed collaboration-enabled Excalidraw web client.
Does it run on Windows or Linux?No. The app is built only for Apple platforms: macOS, iPadOS and iOS.
Where do my drawings go, and can AI see them?Drawings are app-managed files that can sync through iCloud across your Apple devices. Locked files stay hidden from AI, and you can control whether each file is visible to AI.
What is different from just using the browser Excalidraw?Drawings are handled as real app documents with groups, custom sorting, iCloud sync and history checkpoints, instead of loose browser downloads. The canvas itself stays Excalidraw-compatible.
Which file formats can it open and export?It opens, imports, edits and exports .excalidraw, .excalidraw.png and .excalidraw.svg files. It also handles PDF import and export, plus image export.
Can AI tools connect to it?Yes. The app can run as an MCP server over a local HTTP endpoint. Basic mode gives the excalidraw-mcp drawing workflow, and optimized mode adds deeper ExcalidrawZ integration.
How are sensitive drawings protected?You can lock files with local authentication, encrypt them and their checkpoints, and use a Recovery Key for fallback access.
What are similar projects?ipadn, zulu, sill, OpenYoink, Crest, excalidraw, opendisplay, MacPacker
Creator
chocoford
Size
130.3 MB
Stars
2K
Age
3y
Commits · 90 Days