Skip to content

Commit 6a4a975

Browse files
committed
Update readme
1 parent a9d8fb9 commit 6a4a975

19 files changed

Lines changed: 49 additions & 37 deletions

.github/ISSUE_TEMPLATE/bug_report.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,8 +77,10 @@ body:
7777
options:
7878
- macOS (Apple Silicon)
7979
- macOS (Intel)
80-
- Windows (built from source)
80+
- Linux (.deb)
81+
- Linux (AppImage)
8182
- Linux (built from source)
83+
- Windows (built from source, unsupported)
8284
- Other (say which below)
8385
validations:
8486
required: true

.github/workflows/release.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ jobs:
1818
matrix:
1919
include:
2020
# macOS universal (Intel + Apple Silicon).
21-
# macOS-only for nowWindows/Linux runners were dropped to conserve
22-
# the org's free Actions minutes (macOS bills at 10x). Re-add matrix
23-
# entries here to build those platforms again.
21+
# macOS-only in CIthe Linux runner was dropped to conserve the org's
22+
# free Actions minutes; Linux artifacts are built and uploaded by
23+
# scripts/release-local.sh instead. No Windows build for now.
2424
- platform: macos-latest
2525
args: '--target universal-apple-darwin'
2626
rust_target: 'aarch64-apple-darwin,x86_64-apple-darwin'

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -364,8 +364,8 @@ New here? Issues labelled
364364
[`good first issue`](https://github.com/mydevtools-tech/mydevtools/labels/good%20first%20issue)
365365
are scoped to be completable without deep knowledge of the codebase. If none are
366366
open, improving a translation, a tool description or a README translation is
367-
always welcome — and testing the desktop build on Windows or Linux is the most
368-
useful thing a new contributor can do right now.
367+
always welcome — and testing the Linux build (new in 0.1.15) is the most useful
368+
thing a new contributor can do right now.
369369

370370
---
371371

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,8 @@ It runs on your machine. There is no MyDevTools server, no account and no sync.
106106
| Platform | How |
107107
|---|---|
108108
| **macOS** (Apple Silicon + Intel) | [Download the latest `.dmg`](https://github.com/mydevtools-tech/mydevtools/releases/latest) — universal build, signed and notarized, updates itself in-app |
109-
| **Windows / Linux** | Not published yet. The Tauri shell builds on both — see [Building from source](#%EF%B8%8F-building-from-source) and the [roadmap](ROADMAP.md). Testing on these platforms is a great first contribution |
109+
| **Linux** (x86_64) | [Download the `.deb`](https://github.com/mydevtools-tech/mydevtools/releases/latest/download/MyDevTools-amd64.deb) (Debian / Ubuntu 22.04+) or the [AppImage](https://github.com/mydevtools-tech/mydevtools/releases/latest/download/MyDevTools-x86_64.AppImage) (runs anywhere, no install) — same release and version as macOS. No in-app updater yet; see the [Linux install guide](https://mydevtools.tech/linux-builds) |
110+
| **Windows** | No build for now. The Tauri shell compiles on Windows — see [Building from source](#%EF%B8%8F-building-from-source) and the [roadmap](ROADMAP.md) |
110111

111112
Open it and start working: no sign-up, no configuration, no API keys.
112113

ROADMAP.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,6 @@ Current focus — stability and polish over new surface area.
5252

5353
Agreed direction, not yet scheduled.
5454

55-
- **Windows and Linux builds.** The Tauri shell can already be built on both;
56-
what is missing is CI, signing and enough testing to publish them. This is the
57-
most-requested item.
5855
- **More developer utilities**, driven by what people actually ask for in issues.
5956
- **API client depth**: smoother collection workflows, better environment and
6057
secret handling, richer request/response inspection.
@@ -79,6 +76,9 @@ Ideas we like, with nothing committed. Feedback genuinely decides these.
7976
generation and certificate tooling.
8077
- **Local automation**: chaining tools together for repeated workflows, on-device.
8178
- **A public tool API** so the desktop app's logic can be scripted locally.
79+
- **A Windows build.** Not planned for now. The Tauri shell compiles on Windows,
80+
but a published build needs CI minutes, a code-signing certificate and regular
81+
testing we do not have yet. Linux shipped in 0.1.15.
8282

8383
## Not planned
8484

@@ -104,7 +104,7 @@ The fastest way to move something up this list:
104104
- **Open an issue** describing the problem, not just the fix you have in mind.
105105
- **Pick up a [good first issue](https://github.com/mydevtools-tech/mydevtools/labels/good%20first%20issue)** — see [`docs/GOOD_FIRST_ISSUES.md`](docs/GOOD_FIRST_ISSUES.md) for scoped starter work.
106106
- **Improve a translation** — 27 locales, and native speakers always beat a sync script.
107-
- **Test on Windows or Linux** and report what breaks. That is the concrete work
108-
standing between those builds and a release.
107+
- **Test on Linux** and report what breaks. The Linux build is new as of 0.1.15
108+
and has seen far less use than macOS.
109109

110110
See [CONTRIBUTING.md](CONTRIBUTING.md) to get set up.

SUPPORT.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -64,9 +64,10 @@ No. The vault key is derived from your password and never leaves your device, so
6464
there is no reset path. That is what makes the vault meaningful.
6565

6666
**Which platforms are supported?**
67-
Published builds are macOS only today (universal — Apple Silicon and Intel,
68-
signed and notarized). Windows and Linux builds are not published yet; the Tauri
69-
shell can be built from source on those platforms, but is untested.
67+
macOS (universal — Apple Silicon and Intel, signed and notarized) and Linux
68+
(x86_64, as a `.deb` or AppImage) ship in every release. There is no Windows
69+
build for now; the Tauri shell can be built from source on Windows, but is
70+
untested.
7071

7172
**Is it really free?**
7273
Yes — every tool and every feature, no paid tier and no limits. It is open source

apps/web/public/funding.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
{
1515
"guid": "mydevtools",
1616
"name": "MyDevTools",
17-
"description": "An all-in-one, offline-first developer toolkit desktop app with 80+ tools: formatters, converters, encoders, security and crypto utilities, generators, an API client with mock server and SQL/gRPC support, a data explorer, plus notes, bookmarks and tasks. Fully local: no accounts, no sign-in, no cloud sync, no telemetry beyond an opt-in anonymous ping. Data is stored on-device in an encrypted SQLCipher database. Free and open source under AGPL-3.0, shipped as a signed macOS build (Windows and Linux build from source).",
17+
"description": "An all-in-one, offline-first developer toolkit desktop app with 80+ tools: formatters, converters, encoders, security and crypto utilities, generators, an API client with mock server and SQL/gRPC support, a data explorer, plus notes, bookmarks and tasks. Fully local: no accounts, no sign-in, no cloud sync, no telemetry beyond an opt-in anonymous ping. Data is stored on-device in an encrypted SQLCipher database. Free and open source under AGPL-3.0, shipped as a signed, notarized macOS build and Linux .deb/AppImage packages (no Windows build for now).",
1818
"webpageUrl": {
1919
"url": "https://mydevtools.tech"
2020
},

apps/web/src/app/changelog/page.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ export default function ChangelogPage() {
5454
'@id': `${baseUrl}/changelog#software`,
5555
name: 'MyDevTools',
5656
applicationCategory: 'DeveloperApplication',
57-
operatingSystem: 'macOS, Windows, Linux',
57+
operatingSystem: 'macOS, Linux',
5858
softwareVersion: latestRelease.version,
5959
releaseNotes: `${baseUrl}/changelog`,
6060
url: baseUrl,
@@ -81,7 +81,7 @@ export default function ChangelogPage() {
8181
'@type': 'SoftwareApplication',
8282
name: `MyDevTools ${entry.version}`,
8383
applicationCategory: 'DeveloperApplication',
84-
operatingSystem: 'macOS, Windows, Linux',
84+
operatingSystem: 'macOS, Linux',
8585
softwareVersion: entry.version,
8686
datePublished: entry.date,
8787
releaseNotes: entry.changes.map((change) => change.text).join(' '),

apps/web/src/lib/changelog.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -233,7 +233,7 @@ export const changelog: ChangelogEntry[] = [
233233
date: '2026-07-15',
234234
title: 'First public release',
235235
summary:
236-
'The first downloadable MyDevTools desktop build for macOS, Windows, and Linux — 80+ developer tools that run on your device and work offline.',
236+
'The first downloadable MyDevTools desktop build for macOS — 80+ developer tools that run on your device and work offline.',
237237
changes: [
238238
{ type: 'added', text: 'Formatters, converters, generators, validators, cryptography, and network tools in one app.' },
239239
{ type: 'added', text: 'Notes, bookmarks, tasks, and an API client, stored in an encrypted local vault.' },

apps/web/src/lib/seo/comparison-pages.ts

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -840,7 +840,7 @@ export const comparisonPages: ComparisonPage[] = [
840840
eyebrow: 'Comparison',
841841
heading: 'MyDevTools vs DevUtils.app',
842842
intro:
843-
'DevUtils.app is a native Mac app for offline developer utilities. MyDevTools is a cross-platform desktop app that runs offline on macOS, Windows, and Linux, with 80+ tools plus SQL, MongoDB, and Redis database clients.',
843+
'DevUtils.app is a native Mac app for offline developer utilities. MyDevTools is a cross-platform desktop app that runs offline on macOS and Linux, with 80+ tools plus SQL, MongoDB, and Redis database clients.',
844844
competitor: 'DevUtils.app',
845845
primaryCta: { href: '/tools', label: 'Browse MyDevTools' },
846846
sections: [
@@ -859,7 +859,7 @@ export const comparisonPages: ComparisonPage[] = [
859859
body:
860860
'An all-in-one desktop toolkit is better when you work across operating systems or want more than utilities in one app.',
861861
bullets: [
862-
'Run the same offline app on macOS, Windows, and Linux — not just Mac.',
862+
'Run the same offline app on macOS and Linux — not just Mac.',
863863
'Use 80+ tools plus SQL, MongoDB, and Redis database clients in one place.',
864864
'Process everything locally — your data never leaves your machine.',
865865
],
@@ -881,8 +881,8 @@ export const comparisonPages: ComparisonPage[] = [
881881
a: 'Yes, for cross-platform desktop developer utility workflows. DevUtils.app remains stronger if you specifically want a Mac-only native app.',
882882
},
883883
{
884-
q: 'Does MyDevTools work on Windows and Linux?',
885-
a: 'Yes. MyDevTools is a cross-platform desktop app that runs on macOS, Windows, and Linux.',
884+
q: 'Does MyDevTools work on Linux?',
885+
a: 'Yes. MyDevTools ships macOS and Linux (.deb and AppImage) builds in every release. There is no Windows build for now.',
886886
},
887887
],
888888
},
@@ -1116,9 +1116,9 @@ export const comparisonPages: ComparisonPage[] = [
11161116
description:
11171117
'Compare MyDevTools with DevToys: a similar offline all-in-one developer toolkit, with a macOS desktop app, database clients and an API client included.',
11181118
eyebrow: 'Alternative',
1119-
heading: 'DevToys alternative for macOS, with database and API clients built in',
1119+
heading: 'DevToys alternative for macOS and Linux, with database and API clients built in',
11201120
intro:
1121-
'DevToys is a well-liked offline developer toolbox that started on Windows. MyDevTools takes the same local-first idea — one app, many everyday utilities, nothing uploaded — and ships a macOS desktop app that also includes an API client and SQL, MongoDB, Redis and S3 clients.',
1121+
'DevToys is a well-liked offline developer toolbox that started on Windows. MyDevTools takes the same local-first idea — one app, many everyday utilities, nothing uploaded — and ships a macOS and Linux desktop app that also includes an API client and SQL, MongoDB, Redis and S3 clients.',
11221122
competitor: 'DevToys',
11231123
primaryCta: { href: '/tools', label: 'Browse all tools' },
11241124
sections: [
@@ -1147,7 +1147,7 @@ export const comparisonPages: ComparisonPage[] = [
11471147
body:
11481148
'These are different projects with different histories, and neither is strictly better.',
11491149
bullets: [
1150-
'MyDevTools publishes macOS builds today; Windows and Linux builds are not published yet.',
1150+
'MyDevTools publishes macOS and Linux builds today; there is no Windows build for now.',
11511151
'DevToys has a longer track record on Windows and its own extension ecosystem.',
11521152
'Both are open source — MyDevTools is licensed under the GNU AGPL v3.',
11531153
],
@@ -1156,7 +1156,7 @@ export const comparisonPages: ComparisonPage[] = [
11561156
faqs: [
11571157
{
11581158
q: 'Is MyDevTools available on Windows or Linux?',
1159-
a: 'Not as a published build yet. macOS builds are released today as a signed, notarized universal app. The Tauri shell can be built from source on Windows and Linux, but those builds are untested — see the roadmap.',
1159+
a: 'Linux, yes: every release ships a .deb and an AppImage (x86_64) alongside the signed, notarized universal macOS app. Windows, not for now — the Tauri shell can be built from source on Windows, but that build is untested and unsupported. See the roadmap.',
11601160
},
11611161
{
11621162
q: 'Is MyDevTools open source like DevToys?',

0 commit comments

Comments
 (0)