GitHub is where most people first meet Onlook: 27.2k stars, 2.1k forks, a #1 trending run and 100+ contributors. But the README still opens with "The design tool for AI-native designers — now in early access", describes a browser-based editor, says "use our hosted app or run locally" and links to onlook.com/waitlist, and the Releases section is empty. The product today is a free Mac app you can download from onlook.com/install, and the repo's own description already says "The Developer Tool for Visual Engineers". A developer who arrives from a trending list or a Hacker News thread meets the old product and a waitlist instead of a download button.
First action
Replace the README headline and first paragraph with the homepage wording and a Download for Mac link.
How to measure it
/install visits and Mac downloads referred by github.com
- Now
- –
- Target
- 2x the current weekly level
- By
- 30 days
Steps
Baseline
Record a week of GitHub traffic insights (views, referrers) and /install visits referred by github.com.
Engineering lead 1 day
Rewrite the hero
Headline, one-sentence description and a canvas screenshot that match onlook.com.
CEO 2 hours
Add the download link
A "Download for Mac" link to /install with a utm_source=github tag, near the top.
Founding Engineer (Fullstack) 1 hour
Explain repo vs app
A short section on what is open source, what the Mac app adds, and how to run it locally.
Engineering lead half a day
Move the waitlist down
Keep Windows and Linux sign-up as a second link under the download, not the main action.
Design lead 1 hour
Publish a release
Post the current Mac build in GitHub Releases with notes, and repeat for each version.
Engineering lead 1 day
Measure
Compare GitHub-referred downloads with the baseline every week for a month.
CEO weekly
Why it works
Rewrite the top of the README to match the homepage: the one-line "Developer Tool for Visual Engineers" position, a screenshot of the canvas on a real React app, and a "Download for Mac" link to /install with a GitHub tracking parameter. Below it, add a short "What is in this repo" section that explains how the open-source code relates to the Mac app and how to run it locally, then the Windows and Linux waitlist as a secondary link. Publish each Mac build as a GitHub Release with short notes, so people who star or watch the repo see new versions. Keep the contributor guide where it is.
Developers trust the repo more than a marketing site, and the README is the page with the most reach that Onlook controls. It already gets the traffic; changing its first screen turns existing visits into downloads at no cost, and Releases put every new version in front of people who already follow the project.
Ready to use
ChecklistREADME first-screen checklist
[ ] Headline matches the homepage: "The Developer Tool for Visual Engineers" [ ] One sentence: free, local-first Mac app for designers working in real React code [ ] Canvas screenshot on a real app [ ] "Download for Mac" link to /install?utm_source=github [ ] Waitlist link for Windows and Linux under it [ ] "What is in this repo" and "Run locally" sections [ ] Remove "now in early access" and the hosted-app wording [ ] Current build published in Releases with notes
Risks and how to handle them
Contributors lose track of how to run the open-source code
Keep a clear "Run locally" section and link the docs guide.
Windows and Linux visitors hit a Mac-only button
Put the waitlist link directly under the download.
Evidence
- GitHubRepository onlook-dev/onlook (checked November 9, 2026): 27.2k stars, 2.1k forks, Apache-2.0. The README headline is still "The design tool for AI-native designers — now in early access"; it describes a browser-based editor for Next.js and Tailwind, says "use our hosted app or run locally" and links to onlook.com/waitlist. The repo description already says "The Developer Tool for Visual Engineers". The Releases section is empty.Source
- Your websiteInstall page: "Download for Mac" (Apple silicon) and a separate Intel "Download" link; requirements "a Mac with Apple Silicon or an Intel processor running macOS 13 or later"; Windows and Linux: "Join the waitlist"; "as little as 90 seconds — from download to design"; each exploration gets its own git branch; it runs two coding agents with more "coming soon"; the app is free and users bring their own AI account.Source
- Your websiteHomepage (checked November 9, 2026): H1 "The Developer Tool for Visual Engineers", "a free, local-first editor"; the header shows "26.0k" GitHub stars while a banner says "Onlook just crossed 27,000 stars on GitHub!"; the main CTA everywhere is "Download Onlook" (to /install), plus "Book a Demo"; social proof is eight posts from X, with no customer logos or case studies; the footer lists no Docs link.Source
- HiringFounding Engineer (Fullstack), Y Combinator job board (open November 9, 2026): $130K-$200K and 1.00%-4.00% equity, San Francisco or remote (US/Canada); owns large features and code generation and works with "100+ contributors" worldwide; claims #1 on Hacker News and #1 trending GitHub repo; the post cites both "over 22,000" and "over 19,000" GitHub stars. YC lists the company as W25, founded 2024, team size 4; the About page shows 3 people.Source