WI Draw is the visual workspace of the WI Arch ecosystem: an open-source, hand-drawn whiteboard for diagrams, wireframes, flowcharts, mind maps, technical sketches and collaborative thinking.
WI Draw is an independent WI Arch product for drawing diagrams, sketches and plans. It uses an inherited open-source drawing engine; integrations, deployment and future capabilities are developed under WI Arch.
Project status: foundation and rebranding in progress. This repository contains the inherited editor code. Native desktop/mobile applications, WI account integration, cloud workspaces and WI-specific collaboration services are not yet represented as completed features.
- A fast, infinite canvas with a deliberately simple drawing experience.
- Shapes, arrows, connectors, freehand drawing, text, images and reusable libraries.
- Diagrams, architecture maps, process flows, mind maps, planning boards and low-fidelity wireframes.
- Local-first editing with import/export and offline-capable web experience.
- A consistent experience across web, desktop and mobile form factors.
- Optional collaboration and synchronization through services controlled by WI Arch, after their security and operational design is complete.
| Platform | Direction | Status |
|---|---|---|
| Web | Responsive web application and PWA | Inherited foundation; needs WI branding and validation |
| Linux | Desktop application, preferably Tauri | Planned |
| Windows | Desktop application, preferably Tauri | Planned |
| macOS | Desktop application, subject to packaging and signing | Planned |
| Android | Touch-first mobile application, evaluating Capacitor/native integration | Planned |
| iOS/iPadOS | Touch-first mobile application, evaluating Capacitor/native integration | Planned |
The current codebase is a React/TypeScript web monorepo. Desktop and mobile packaging are roadmap items, not existing capabilities.
- React and TypeScript
- Vite
- Yarn workspaces
- Canvas-based editor and internal drawing packages
- PWA/service-worker support inherited from the upstream codebase
- Existing collaboration integrations are under review before being adopted as WI services
Exact dependency and script versions are maintained in the workspace manifests. Do not upgrade or replace the package manager without checking the lockfile and workspace tooling.
- Node.js 18 or newer (use the version supported by the current CI configuration).
- Yarn 1.22.22, as declared by the root
package.json.
yarn install
yarn startyarn test:typecheck
yarn test:code
yarn test:app --watch=false
yarn buildRun the relevant checks after changes. Do not assume that a successful dependency installation means the app builds or that platform packaging works.
excalidraw-app/: current web application entry point and app-specific features.packages/: reusable drawing engine and supporting packages.examples/: integration examples.dev-docs/: inherited developer documentation site.scripts/: build, release and maintenance tooling.
Some internal folder and package names still reflect the upstream project. They will be renamed only when all imports, build scripts, package references and published interfaces can be updated safely.
- Keep the editor fast, accessible and usable without an account.
- Do not require cloud connectivity for local drawing and export.
- Treat drawings and embedded assets as user data.
- Keep synchronization and collaboration opt-in until the WI services are ready.
- Never claim end-to-end encryption, zero-knowledge storage or secure sharing without a documented design, implementation review and tests.
- Keep platform-specific capabilities behind well-defined adapters rather than coupling the drawing engine to one operating system.
See third-party notices for inherited code and license information.
- Product definition
- Architecture
- Roadmap
- Security policy
- VPS deployment guide
- Instructions for AI coding agents
- Implementation prompt
Part of the WI Arch ecosystem.