diff --git a/.github/assets/first-launch-macos-open-anyway.png b/.github/assets/first-launch-macos-open-anyway.png new file mode 100644 index 0000000..4576578 Binary files /dev/null and b/.github/assets/first-launch-macos-open-anyway.png differ diff --git a/.github/assets/first-launch-windows-more-info.png b/.github/assets/first-launch-windows-more-info.png new file mode 100644 index 0000000..705bca9 Binary files /dev/null and b/.github/assets/first-launch-windows-more-info.png differ diff --git a/.github/assets/first-launch-windows-run-anyway.png b/.github/assets/first-launch-windows-run-anyway.png new file mode 100644 index 0000000..18183ed Binary files /dev/null and b/.github/assets/first-launch-windows-run-anyway.png differ diff --git a/.github/assets/start-all.gif b/.github/assets/start-all.gif new file mode 100644 index 0000000..3c44015 Binary files /dev/null and b/.github/assets/start-all.gif differ diff --git a/README.md b/README.md index 73bd8e3..e1ad531 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,9 @@ localhost (getlocalhost.app) is a free, open-source desktop process manager for MIT license

-![The localhost window: the Acme Shop Project with its Services (Migrations exited, API, Web and Worker running, Storybook manual) and their merged log](.github/assets/main-window-dark.png) +

+ Start All on the Acme Shop Project: Database, Migrations, API, Web and Worker start in dependency order, Migrations exits once done, and every Service's output streams into one merged log +

localhost remembers how each of your local development projects runs, and lets you start, stop and watch all of its Services from one place, instead of a row of terminal tabs. @@ -32,6 +34,8 @@ A **Project** is a folder. A **Service** is one long-running command in it: `pnp A native SwiftUI app on macOS with a menu bar companion; one app for Linux and Windows with a tray icon. On Windows, Projects run on Windows itself or inside WSL. +![The localhost window on macOS: the Acme Shop Project with its Services (Migrations exited, API, Web and Worker running, Storybook manual) and their merged log](.github/assets/main-window-dark.png) + ## Install Download the latest release from [GitHub Releases](https://github.com/marcellosso/localhost/releases/latest). @@ -162,6 +166,9 @@ Releases aren't notarized by Apple yet, so macOS refuses to open what your brows 2. Open **System Settings → Privacy & Security** and scroll to **Security**. It says the item was blocked to protect your Mac. 3. Click **Open Anyway**, confirm with your password or Touch ID, then click **Open Anyway** once more. +

System Settings, Privacy & Security: under Security, “localhost” was blocked to protect your Mac, with an Open Anyway button

+

System Settings → Privacy & Security → Open Anyway.

+ If the warning named the DMG, macOS may ask again the first time you open localhost: do the same. **Download from Terminal.** macOS only checks files marked as downloaded from the internet, and `curl` doesn't mark them. Download and open the DMG, then drag **localhost** to **Applications** as usual: @@ -183,6 +190,11 @@ xattr -dr com.apple.quarantine /Applications/localhost.app Unsigned releases make SmartScreen say “Windows protected your PC”. Click **More info**, check that the file name is what you downloaded from this project's releases, then click **Run anyway**. Each new version asks once again. +

SmartScreen's “Windows protected your PC” dialog, with the More info link

+

Click More info…

+

The same dialog after More info: the app's file name, Publisher: Unknown publisher, and the Run anyway button

+

…check the file name, then click Run anyway.

+ ## Platform notes ### macOS: Keychain prompts for Secrets diff --git a/site/src/content/docs/install.md b/site/src/content/docs/install.md index e48b8e6..54df429 100644 --- a/site/src/content/docs/install.md +++ b/site/src/content/docs/install.md @@ -22,6 +22,9 @@ Releases aren't notarized by Apple yet, so macOS refuses to open what your brows 2. Open **System Settings → Privacy & Security** and scroll to **Security**. It says the item was blocked to protect your Mac. 3. Click **Open Anyway**, confirm with your password or Touch ID, then click **Open Anyway** once more. +![System Settings, Privacy & Security: under Security, “localhost” was blocked to protect your Mac, with an Open Anyway button](../../../../.github/assets/first-launch-macos-open-anyway.png) +*System Settings → Privacy & Security → Open Anyway.* + If the warning named the DMG, macOS may ask again the first time you open localhost: do the same. **Download from Terminal.** macOS only checks files marked as downloaded from the internet, and `curl` doesn't mark them. Download and open the DMG, then drag **localhost** to **Applications** as usual: @@ -43,4 +46,10 @@ xattr -dr com.apple.quarantine /Applications/localhost.app Unsigned releases make SmartScreen say “Windows protected your PC”. Click **More info**, check that the file name is what you downloaded from this project's releases, then click **Run anyway**. Each new version asks once again. +![SmartScreen's “Windows protected your PC” dialog, with the More info link](../../../../.github/assets/first-launch-windows-more-info.png) +*Click More info…* + +![The same dialog after More info: the app's file name, Publisher: Unknown publisher, and the Run anyway button](../../../../.github/assets/first-launch-windows-run-anyway.png) +*…check the file name, then click Run anyway.* + Next: [add your first Project](/docs/quick-start).