Skip to content

AI-native design editor. Open-source Figma alternative.

9.1 KB
Raw Blame

title: Privacy and Usage Stats description: What OpenPencil sends over the network, why it sends anonymous usage stats, and how to turn every part of it off.

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:

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

{ "version": "0.16.0", "platform": "macos", "arch": "arm64", "app": "desktop", "browser": "unknown", "usageStats": "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 ({{ buildFields }}). 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.

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 ({{ buildFields }}), 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:

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.

Feature Where it connects
Update checks (desktop) GitHub Releases, for the latest version number
AI chat and image tools The 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 rooms Other people in the room directly; public brokers introduce peers, and a TURN relay carries traffic when a direct connection is not possible
Cloud storage The storage provider you configure
Fonts Google Fonts, which can supply a font a document uses that is not installed
Icons The Iconify API, when you search or insert icons
Stock photos Unsplash 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.