Skip to content

Add the Start All demo GIF to the README, and mark where the first-launch screenshots go - #17

Open
marcellosso wants to merge 1 commit into
mainfrom
docs/demo-assets
Open

marcellosso wants to merge 1 commit into
mainfrom
docs/demo-assets

Conversation

@marcellosso

@marcellosso marcellosso commented Oct 23, 2026 •

Copy link
Copy Markdown
Owner

Closes #16

Summary

+.github/assets/start-all.gif   # 1200×720, 24 s, 842 KB: Start All on a sample Project, merged log
 README.md                      # GIF at the top (width/height + alt); macOS screenshot moved below the feature list
 README.md + site/src/content/docs/install.md   # TODO(#16) comments where the first-launch screenshots go

The landing page is unchanged: its live demo stays as it is.

How the GIF was made (one-off, not committed). The desktop app's real UI ran in headless Chromium, driven by Playwright. Its Tauri calls went to a real localhostd --stdio, which started 5 shell-script Services: Database, Migrations, API, Web and Worker. Each prints dev-server-style output and listens on $PORT, so Dependencies, Port readiness, the states and the merged log are localhost's own. The frames were encoded with gifski. The UI is the Linux/Windows app, so shortcuts read Ctrl.

First-launch screenshots weren't captured. They're left for Marcel. Getting the real Gatekeeper/System Settings UI would mean scripting clicks on this Mac, and the SmartScreen dialog needs a Windows machine. I didn't want to fake either one. Each spot holds an HTML comment (it doesn't render on GitHub or the site) with alt text and a caption ready:

Save as What it shows
.github/assets/first-launch-macos-open-anyway.png System Settings → Privacy & Security, scrolled to Security: "“localhost” was blocked…" with Open Anyway. Window only (⌘⇧4, Space).
.github/assets/first-launch-windows-more-info.png SmartScreen's "Windows protected your PC", with the More info link.
.github/assets/first-launch-windows-run-anyway.png The same dialog after More info: App name, "Publisher: Unknown publisher", Run anyway.

To add them: run pngquant --force --quality 80-95 --ext .png <file> && oxipng -o 4 --strip safe <file>, uncomment the blocks in README.md and install.md, and fill in WIDTH/HEIGHT in the README <img>s. Astro sets the dimensions on the docs images itself.

Evidence

GIF: https://github.com/marcellosso/localhost/blob/docs/demo-assets/.github/assets/start-all.gif

$ cd site && pnpm build
[build] Complete!

Merge Danger

Door: two-way

Blast Radius: README

It adds one 842 KB GIF. The docs only gain HTML comments.

@vercel

vercel Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
localhost-web Ready Ready Preview Oct 23, 2026 4:46pm UTC

@marcellosso marcellosso changed the title Add the Start All demo, generated from the real UI and core, and mark where the first-launch screenshots go Add the Start All demo GIF to the README, and mark where the first-launch screenshots go Oct 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a Start All demo GIF and first-launch screenshots to the README, homepage and install docs

1 participant