Skip to content

README as a product page; install moves to INSTALL.md - #17

Merged
dinooo13 merged 3 commits into
mainfrom
readme-product-page
Sep 12, 2026
Merged

dinooo13 merged 3 commits into
mainfrom
readme-product-page

Conversation

@dinooo13

Copy link
Copy Markdown
Owner

Summary

Rewrites the README as a product page aimed at people who dictate prompts to Claude Code, Codex, Cursor and OpenCode, and moves everything operational to a new INSTALL.md.

  • README.md: headline, hero figure of the pill in its three states, why, agents, the M1 speed table, privacy, how it works, three-line install, FAQ written as literal questions. Light and dark images via <picture>. An HTML comment marks where the hero GIF goes once recorded.
  • INSTALL.md: requirements, build and install, first launch, updating, uninstalling, signing, CLI, icon and screenshot scripts, troubleshooting.
  • docs/images/: flow and overlay-styles figures in light and dark, plus a 1280×640 social preview card for the repo settings.
  • Screenshot mode: SpeakUp --screenshots <dir> renders the real overlay pill on a stand-in desktop and quits. It never starts the hotkey, microphone or engine, so it can run beside a copy in use. scripts/make-screenshots.sh wraps it.

Not on the critical path; no benchmark needed. Repo description and topics were updated separately.

Test plan

  • swift build and swift test (59 tests) pass
  • scripts/make-screenshots.sh renders all five images
  • README renders correctly on GitHub in light and dark
  • Upload docs/images/social-preview.png under Settings → Social preview

🤖 Generated with Claude Code

dinooo13 and others added 3 commits September 12, 2026 03:29
The README now sells SpeakUp to people who talk to agents: hero figure,
why, agents, the M1 speed table, privacy, a FAQ in plain questions for
search, and a three-line install. Everything operational (requirements,
first launch, updating, uninstalling, signing, CLI, troubleshooting) is
in INSTALL.md.

The pictures are rendered from the app's own views by a new
`--screenshots <dir>` launch flag, which shows the real overlay pill on a
stand-in desktop in light and dark and quits without starting the
hotkey, microphone or engine. scripts/make-screenshots.sh wraps it and
also produces the social preview card.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@dinooo13
dinooo13 merged commit 3fdf485 into main Sep 12, 2026
1 check passed
@dinooo13
dinooo13 deleted the readme-product-page branch September 12, 2026 01:30
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.

1 participant