Skip to content

Privacy and Usage Stats ​

  • Your designs, file names, layer names, text, prompts, and keys never leave your device unless you share or sync them yourself, or attach a design to a report you send.
  • Official builds send one anonymous ping a day, with no ID. You can turn it off.
  • Detailed usage stats are sent only if you say yes when asked, and you can stop at any time.

Why we collect anything ​

OpenPencil is built by a small team. We need to know which platforms, file formats, and features people use so we can decide what to build next. We also need to show that OpenPencil is used, because that is what keeps the project funded. A count of active installs and a picture of which features matter answer both questions without knowing anything about you or your work.

The daily ping ​

Once a day, an official build sends this to feedback.openpencil.dev:

http
POST https://feedback.openpencil.dev/ping

{ "version": "0.16.0", "platform": "macos", "arch": "arm64", "app": "desktop", "browser": "unknown", "usageStats": "denied" }
FieldValues
version
The OpenPencil version, such as 0.16.0.
A version number
platform
The operating system family.
macos, windows, linux, ios, android, unknown
arch
The processor architecture, known on desktop only.
arm64, x64, unknown
app
The desktop app or the web app.
desktop, web
browser
The browser family, for the web app.
chrome, edge, opera, firefox, safari, unknown
usageStats
Whether this install shares usage stats, declined, or has not answered yet.
unset, granted, denied

It carries no ID, so pings from the same install cannot be linked. The answer to the usage stats question is the only way we learn how many people decline, since declining means nothing else is ever sent. The app stores only the date of its last ping, so it pings once a day. The server adds one to a counter for that day and build. It also adds one to a counter for that day, the app and platform, and the network the ping came from: the network's number and operator name as Cloudflare reports them, such as a home internet provider, a university, or a cloud host. That tells real people apart from automated installs running in data centers, without anything that identifies a device. The server keeps nothing else. It does not log addresses, and it rejects a ping that carries any other field.

The ping is on by default. Turn it off in Settings → Privacy.

Usage stats ​

Usage stats are off until you agree. OpenPencil asks once, in a small prompt that appears after the welcome screen on first launch, or on a later launch if you have not answered, with two equal choices: No thanks and Share stats. Nothing is selected for you, and you can change your answer later in Settings → Privacy.

When you agree, the app creates a random install ID on your device. It is not linked to an account, an email address, or anything else about you. Usage events are sent with it, together with the build fields above (version, platform, arch, app, browser). When you stop sharing, the app deletes the ID; agreeing again creates a new one.

These are all the events the app can send. The service at feedback.openpencil.dev checks every event against this list and rejects any event, property, or value that is not on it, so a modified app cannot send anything else through it either.

app_opened

OpenPencil started.

FieldValues
locale
The interface language.
en, de, es, fr, it, ja, pl, ru, zh-CN

document_opened

A file was opened.

FieldValues
format
The file format.
fig, pen, drawio, mermaid, png, jpg, webp, svg, pdf, pptx, jsx, tailwind-jsx, html

document_exported

A file was exported.

FieldValues
format
The export format.
fig, pen, drawio, mermaid, png, jpg, webp, svg, pdf, pptx, jsx, tailwind-jsx, html

ai_reply_finished

The AI assistant finished a reply.

FieldValues
provider
Which kind of AI provider or agent answered.
openrouter, anthropic, openai, chatgpt, google, deepseek, openai-compatible, zai, minimax, anthropic-compatible, openpencil, harness:pi, acp:claude-code, acp:codex, acp:gemini-cli, acp:cursor, acp:grok-build

usage_stats_enabled

Usage stats were turned on, sent once with the agreement itself.

FieldValues
source
Where: right after the first-run welcome, on a later launch, or in Settings.
welcome, prompt, settings

donate_clicked

The donation page was opened; whether a donation followed is not known.

FieldValues
source
Where: the question the app asks, the File menu, or Settings.
prompt, menu, settings

Accepted events go to PostHog, a product analytics service, on its EU cloud. The request comes from our server, not your device, so PostHog never sees your address. Events create no person profiles and skip location lookups. We keep usage stats for 12 months.

Error and problem reports ​

When OpenPencil's own code throws an unexpected error, an official build adds Report… to the error notice; errors from browser extensions or without a stack trace get none. If OpenPencil closed unexpectedly after an error, or the desktop app hit an internal error, the next launch offers the same, once. File → Report a problem… is always there. Both open a form, and nothing is sent until you choose Send report. What will be sent shows the exact report before it goes. It has:

  • For an error: its type and message, scrubbed of keys, tokens, email addresses, and your user name in folder paths, and where in OpenPencil's code it happened. Errors from AI providers, which can quote your prompts, are sent without a message.
  • What you write, and an email address if you give one so we can reply.
  • The build fields above (version, platform, arch, app, browser), and your install ID if you share usage stats.
  • If you leave Include recent activity on: the last 50 events from Settings → Diagnostics, such as errors, timings, and file formats. They never include chat messages or tool output.
  • If you turn on Attach this document: the open design as a .fig file.

Besides the build fields, a report has these fields:

FieldValues
kind
An error the app caught, or a problem you describe.
error, problem
exceptions
For an error: each error in its chain, with its type, its scrubbed message, whether the app handled it, where it was raised, and the code locations it passed through.
Free-form
installId
Your install ID, only while you share usage stats.
Free-form
release
Which release the app’s code came from, so the code locations can be read.
Free-form
note
What you wrote.
Free-form
email
The email address you gave, if any, so we can reply.
Free-form
steps
If you include recent activity: the latest diagnostics events, each with its name, category, level, time, and scrubbed details.
Free-form
files
If you attach the open document: the name it is sent under and its size.
document.fig

Reports go to feedback.openpencil.dev, which passes them to PostHog's error tracking on its EU cloud, without your address, a person profile, or a location lookup, and keeps nothing of them itself. An attached design is stored in Cloudflare R2 in the EU, only the OpenPencil team can open it, and it is deleted after 90 days.

Turning it all off ​

  • Settings → Privacy has a switch for the ping and one for usage stats.
  • In the desktop app, starting OpenPencil with OPENPENCIL_TELEMETRY=0 or DO_NOT_TRACK=1 in its environment turns off both.
  • Only official releases send anything. Development servers, self-built apps, and forks send nothing, because the switch that enables sending is set only when we build a release.

Cloud waitlist ​

If you join the OpenPencil Cloud waitlist on this site, we store your email address and the optional note you add. We send one email to confirm the address and write again only when Cloud is ready for you. Addresses that are not confirmed are deleted after seven days, and every email has a link that removes yours.

Other network requests ​

OpenPencil is local-first, but some features reach the network. The desktop app checks for updates on its own; everything else below connects only when you use that feature, and only to the service named.

FeatureWhere it connects
Update checks (desktop)GitHub Releases, for the latest version number
AI chat and image toolsThe provider you configure, with your own key; the model list comes from models.dev. With OpenPencil Cloud as the provider, the AI service your Cloud server names, with a token for your workspace
Collaboration roomsOther people in the room directly; public brokers introduce peers, and a TURN relay carries traffic when a direct connection is not possible
Cloud storageThe storage provider you configure
FontsGoogle Fonts, which can supply a font a document uses that is not installed
IconsThe Iconify API, when you search or insert icons
Stock photosUnsplash or Pexels, with your own key, when you search them or place one of their photos

The app, the feedback service, and this page are open source. The event list lives in packages/feedback/src/contract, and the tables above are generated from it.

Released under the MIT License.