Repository navigation
Website: macbox on GitHub Pages, with guides for macOS, Xcode and the iOS Simulator on Linux - #4
Conversation
site/ builds https://tuna-nope.github.io/macbox/ with a standard-library Python script: the overview (features, official support for AI coding agents and T3 Code, measured performance, the comparison, requirements, quick start, FAQ) and seven guides (macOS, Xcode and the iOS Simulator on Linux, Expo apps, agents and T3 Code, the GPU path, Docker-OSX and OSX-KVM). Every page is plain HTML with a canonical URL, a unique title and description, structured data (WebSite and SoftwareSourceCode on the overview, TechArticle and BreadcrumbList on guides), and a Markdown copy for language models. The build writes the sitemap, copies the pictures and llms.txt from the repo, and fails on a broken link or anchor, a duplicate title or description, or a macbox / mac-sim command the CLI doesn't have. .github/workflows/pages.yml builds it on pull requests and deploys it from main, then submits the sitemap's URLs to IndexNow. README and llms.txt link to the site and its guides. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… merge) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 35b26e2b1f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| out = out.replace("{{url}}", canonical or SITE_URL + "/") | ||
| out = out.replace("{{site}}", SITE_URL) | ||
| # links from the site's root get the base path; external and #-links stay as they are | ||
| out = re.sub(r'(href|src|srcset)="/(?!/)', lambda m: f'{m.group(1)}="{BASE_PATH}/', out) |
There was a problem hiding this comment.
Prefix every image candidate in srcset with the base path
On the default GitHub Pages deployment, this substitution only prefixes the first URL in a srcset attribute. The generated home page therefore contains srcset="/macbox/images/hero-800.webp 800w, /images/hero-1600.webp 1600w". Browsers selecting the 1600w candidate, including typical desktop and high-density displays, request the image outside /macbox/, leaving the hero image broken. Rewrite each candidate URL rather than only the URL immediately following the opening quote, and include srcset candidates in the internal-link checks.
Useful? React with 👍 / 👎.
…rsions Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ured data Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The hero's srcset only had its first candidate prefixed with /macbox, so browsers picked /images/hero-1600.webp and got a 404. Prefix every candidate, and have the link check read srcset too. The home page now leads with what agents get (a Mac and iOS Simulators on Linux) in plain language; the GPU details and the exact benchmark table moved into fold-outs. The hero image loses its empty top strip and sits in a window frame. Drop the 'Open source' label: the license is PolyForm Noncommercial. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Regular-weight headlines, pill buttons, a thin page frame, and painted grainy panels that hold crisp HTML mock-ups: an agent's session next to the two real simulator screens, T3 Code's Device panel, sim-fps's result and the simulator pool. The mock-ups use real commands, the default pool's names and sim-fps's own wording, and are labelled as an illustration. Also: keep guides at reading width inside the frame, fix grid overflow on phones, and darken the accent and step numbers for contrast. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Home page rewritten: centred hero, a real screen capture of macOS in macbox (Simulator.app running a demo app next to its site in Safari), rounded tiles, a dark performance section, full-width sections. - "Works with" shows Claude Code, Codex and T3 Code with their logos. - New stylesheet: system fonts, Apple-like type scale and colours, light and dark; links in running text keep a thin underline. - build.py: don't double-escape hex entities such as ' in guide descriptions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The home page's picture is now the full 1600x1200 capture of the VM's screen, menu bar and Dock included, on every screen size. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds an official website at https://tuna-nope.github.io/macbox/, built from
site/and published with GitHub Pages.What's in it
/): what macbox is, features, official support for AI coding agents (Claude Code, Codex) and T3 Code, how it works, the measured performance (the chart and numbers fromdocs/performance.md), the comparison with Docker-OSX / OSX-KVM / cloud / a Mac, requirements, quick start, FAQ, and Apple's license note./guides/run-macos-on-linux//guides/xcode-on-linux//guides/ios-simulator-on-linux//guides/expo-react-native-ios-on-linux//guides/ios-simulator-for-ai-coding-agents/(Claude Code, Codex, T3 Code)/guides/gpu-accelerated-macos-vm-on-linux//guides/macbox-vs-docker-osx-and-osx-kvm/How it's built
site/build.pyuses only Python's standard library, so there's nothing to install: no Jekyll, no npm. Pages are HTML fragments insite/pages/, and each file's path is its URL.site/README.mdexplains how to add a guide.docs/stays the reference, and the guides link to it. The pictures (docs/images) andllms.txtare copied from the repo at build time. The only derived files are the hero's WebP copies.#anchor<h1>macbox <cmd>ormac-sim <cmd>in a code sample that the CLI doesn't dispatch. This guards the guides against drifting from the CLI.index.md, linked withrel="alternate") for language models, following llmstxt.org.robots.txtcan't be set for a project site: crawlers read it only attuna-nope.github.io/robots.txt, which doesn't exist, so everything is allowed..github/workflows/pages.ymlbuilds and checks the site on PRs. On pushes to main it deploys, then submits the sitemap's URLs to IndexNow (Bing and others) with the key file served under/macbox/.Checked
html-validate(standard rules): all 10 pages valid.Published and registered (before merge)
The site is already live from this branch. To do that, I temporarily allowed
site/github-pagesto deploy. That trigger and the environment rule are both removed again, so from now on onlymaindeploys. Merging changes nothing visible./guides/xreturns a 301 to/guides/x/.https://tuna-nope.github.io/macbox/, verified with the HTML file (site/static/google2a79202c4df40a46.html). Keep this file, or the verification is lost.sitemap.xmlwas submitted.🤖 Generated with Claude Code