Skip to content

Website: macbox on GitHub Pages, with guides for macOS, Xcode and the iOS Simulator on Linux - #4

Merged
0xdaniell merged 9 commits into
mainfrom
site/github-pages
Nov 6, 2026
Merged

0xdaniell merged 9 commits into
mainfrom
site/github-pages

Conversation

@0xdaniell

@0xdaniell 0xdaniell commented Oct 29, 2026 •

Copy link
Copy Markdown
Owner

Adds an official website at https://tuna-nope.github.io/macbox/, built from site/ and published with GitHub Pages.

What's in it

  • Overview (/): 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 from docs/performance.md), the comparison with Docker-OSX / OSX-KVM / cloud / a Mac, requirements, quick start, FAQ, and Apple's license note.
  • Seven guides, one search intent each, using only commands and numbers that are already in the repo:
    • /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.py uses only Python's standard library, so there's nothing to install: no Jekyll, no npm. Pages are HTML fragments in site/pages/, and each file's path is its URL. site/README.md explains how to add a guide.
  • One source of truth. The repo's docs/ stays the reference, and the guides link to it. The pictures (docs/images) and llms.txt are copied from the repo at build time. The only derived files are the hero's WebP copies.
  • The build fails on any of these:
    • a broken internal link or #anchor
    • a missing or duplicate title or description
    • a page without exactly one <h1>
    • a macbox <cmd> or mac-sim <cmd> in a code sample that the CLI doesn't dispatch. This guards the guides against drifting from the CLI.
  • Search and agents:
    • Every page is readable HTML without JavaScript (the only script is an optional Copy button).
    • Every page has a canonical URL, a unique title and description, Open Graph tags and robots meta tags.
    • Structured data: WebSite and SoftwareSourceCode on the overview, TechArticle and BreadcrumbList on the guides. There is no FAQ or HowTo markup, because Google no longer shows it.
    • There is a sitemap, and each page has a Markdown copy (index.md, linked with rel="alternate") for language models, following llmstxt.org.
    • robots.txt can't be set for a project site: crawlers read it only at tuna-nope.github.io/robots.txt, which doesn't exist, so everything is allowed.
  • .github/workflows/pages.yml builds 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/.
  • README gets a link to the website, and llms.txt gets a "Website" section that lists the guides' Markdown copies. Both edits are placed away from docs: invite all community contributions and agent-assisted PRs #3's hunks, so the two PRs merge cleanly.

Checked

  • Lighthouse, mobile, home page and one guide: 100 in Performance, Accessibility, Best Practices and SEO (LCP 1.1 s locally).
  • html-validate (standard rules): all 10 pages valid.
  • Checked in a real browser at desktop (1280) and mobile (375) widths, in light and dark mode. Found and fixed: horizontal overflow on mobile, a squashed logo, uneven stat columns, a low-contrast element, and breadcrumb order.

Published and registered (before merge)

The site is already live from this branch. To do that, I temporarily allowed site/github-pages to deploy. That trigger and the environment rule are both removed again, so from now on only main deploys. Merging changes nothing visible.

  • GitHub Pages is enabled with the GitHub Actions source, and the repo's homepage link now points to the site.
    • Every page returns 200.
    • /guides/x returns a 301 to /guides/x/.
    • http returns a 301 to https.
    • Unknown paths return the custom 404.
    • Responses are gzip.
  • Google Search Console: a URL-prefix property for https://tuna-nope.github.io/macbox/, verified with the HTML file (site/static/google2a79202c4df40a46.html). Keep this file, or the verification is lost.
    • sitemap.xml was submitted.
    • URL Inspection and a live test were run on all 9 URLs: crawl allowed, fetch successful, indexable, and the canonical is the declared one.
    • Indexing was requested for all 9, and each request was accepted. None is indexed yet.
  • Bing Webmaster Tools: the site was imported from Search Console, and the sitemap came with it (status "Processing").
    • All 9 URLs were sent through URL Submission.
    • A live URL test on the home page says it "can be indexed", with no SEO issues.
    • IndexNow returns HTTP 200 from the workflow.
  • Rich Results Test on a guide: the Article and the Breadcrumbs are both valid, with no warnings.

🤖 Generated with Claude Code

0xdaniell and others added 2 commits October 29, 2026 12:21
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>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-29T12:23:43.091904Z 35b26e2 PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread site/build.py Outdated
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)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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>
0xdaniell and others added 2 commits October 29, 2026 13:18
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 &#x27; 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>
@0xdaniell
0xdaniell merged commit a5b84c1 into main Nov 6, 2026
4 checks passed
@0xdaniell
0xdaniell deleted the site/github-pages branch November 6, 2026 15:40

This branch was previously deployed

1 inactive deployment
github-pages — 8479d80f Deployed Oct 29, 2026 by 0xdaniell via deploy #14
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