Skip to content
D1Explorer
Download

Support

Getting Help

We're here to help you get the most out of D1Explorer. Below you'll find answers to common questions and ways to reach us.

Common Questions

How do I connect to my Cloudflare D1 database?

You'll need a Cloudflare API token with D1 read/write permissions. In the App, go to Settings and add your Cloudflare account with your API token. Your databases will appear automatically once authenticated.

Cost & Budget says my token can't read analytics

Cost & Budget reads your usage from Cloudflare's analytics API, which needs a permission that a D1-only token does not carry. Edit the token in the Cloudflare dashboard, add Account > Account Analytics > Read alongside your existing D1 permission, then update the token on that connection in Settings. Everything else in the app works without it.

Which API token permissions does D1Explorer need?

Different features need different permissions, and no single Cloudflare token template covers all of them. Rather than guess, open Connection Doctor from the toolbar or by right-clicking a connection in the sidebar — it probes each capability live and tells you exactly which permission is missing.

A token missing a permission never breaks the rest of the app: the affected feature explains what to add, and everything else keeps working.

Where are my API tokens stored?

All API tokens are stored securely in the system Keychain. They are never sent to our servers or any third party — only to Cloudflare's API endpoints.

The App cannot connect to Cloudflare

Please verify the following:

How do I open a local SQLite file?

Use File → Open or drag and drop a .sqlite / .db file directly into the App window. The file will be opened in read-write mode.

Can I use D1Explorer offline?

Yes — you can work with local SQLite files without an internet connection. Cloudflare D1 databases require an active connection to Cloudflare's API.

Where does the SQL that Draft SQL writes come from?

Draft SQL uses Apple's on-device Foundation model, so the work happens on your Mac and no cloud AI service is involved. The model is given your question and this database's table and column names and types, never a value from any row, and nothing is uploaded.

It cannot produce a write. D1Explorer describes a query as a set of conditions rather than as text, and that description has no way to express an insert, update or delete, so a draft is only ever a SELECT. The statement is placed in the query editor rather than run, so you decide whether to run it.

The Draft SQL field is missing

Drafting needs Apple Intelligence, which must be switched on in System Settings and have finished downloading its model. Where it is unavailable the field is hidden, because it is the one feature that cannot run without it. The query editor itself is unchanged, and there is a switch in Settings, under General, to turn drafting off.

System Requirements

Useful Links

Send Feedback

Found a bug, or want D1Explorer to do something it doesn't? The feedback form is the quickest route — no account, and nothing is posted publicly. An email address is optional; leave it blank and the report is anonymous.

Opening it from inside the app (Help → Send Feedback) fills in your app version, macOS version, Mac model and language. You can see all four on the page before you send, edit them, or clear them entirely — the app itself never transmits anything.

Send feedback

Report an Issue Publicly

Prefer a public tracker? Opening an issue on GitHub means other users can add context and see when a fix ships. It needs a GitHub account, and your report is visible to everyone.

Open a new issue on GitHub

Contact Us

For anything you would rather not post publicly — licensing, press, or a report involving private data — email us directly:

support@mgcrea.io