Skip to content

Add the /vs comparison hub and Tryit vs Brilliant on one dynamic route - #605

Merged
shtse8 merged 1 commit into
mainfrom
agent/tryit-vs-hub-and-brilliant
Nov 18, 2026
Merged

shtse8 merged 1 commit into
mainfrom
agent/tryit-vs-hub-and-brilliant

Conversation

@shtse8

@shtse8 shtse8 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

https://tryit.fun/vs returns 404 today. This PR fixes that, adds a Tryit vs Brilliant page aimed at "brilliant alternative" and "daily logic puzzles like Brilliant" searches, and folds the five copy-paste /vs/<rival> route files into one dynamic route.

What players and search engines get

  • /vs hub in all 8 locale URLs. It uses the broadsheet look from Redesign Tryit as a tactile daily puzzle broadsheet #604: the masthead rule, then a printed card per comparison. Each card shows the board of the closest Tryit game (for example "Like Wordle? Try Five") and that comparison's own two-line verdict, so the hub never states anything its pages don't. It also has play and pricing CTAs (entry_surface=seo_vs-hub), a short "How we compare" section and CollectionPage + ItemList JSON-LD.
  • /vs/brilliant. Brilliant gets credit for structured courses from fractions to calculus and Python, the Koji tutor, and school accreditation. Tryit wins on 19 daily puzzles on one page, any 3 free in the browser with no account, app or placement quiz, and the 3-Day Pass. Pairings use the real roster: Cage Sudoku, Crowns, Arithmo, Path, Slides and Cipher. CTAs use entry_surface=seo_vs-brilliant, the same seo_vs-<slug> pattern as the other five pages. The visible FAQ and FAQPage come from the same list, and a test checks they match item for item.
  • Breadcrumb: every comparison page now shows "Compare / Tryit vs X" linking to /vs, plus a BreadcrumbList node.
  • Footer: a new Compare column lists all six comparisons and "All comparisons →" (labels added in en-US, es, ja, pt-BR, zh-CN and zh-HK; en-GB and zh-TW inherit, like the existing Compare labels).
  • Sitemap and llms.txt now include /vs and /vs/brilliant.

Brilliant facts (read 18 November 2026, Brilliant's own pages only)

  • brilliant.org: "personal tutor for math and coding" with Koji. Topics run from grade 5 to college: math foundations through calculus, probability and statistics, puzzles and logic, Python, CS and AI. Brilliant cites ACS WASC accreditation, the kidSAFE COPPA seal and 5,000+ schools.
  • Help Center, "free vs Premium" (updated 30 Oct 2026): the free plan gives 2 concepts or practice sets a day, worked through in order, with occasional ads and a limited Koji preview. Premium removes those limits.
  • Help Center, "get started": you sign up first, with email, Google or Apple.
  • Help Center, "Premium cost" (updated 30 Oct 2026): monthly, annual and a Family Plan for up to 6, priced on the subscription page, with occasional discounts. No Brilliant price is quoted because it varies by plan and offer.
  • Operator: Brilliant Worldwide, Inc. (Terms of Use, Privacy Policy).
  • All Tryit prices come from config/commercial/catalogue.json.

Less code

  • The five wrapper directories are deleted. vs/[rival]/page.tsx uses generateStaticParams over 8 locales × 6 slugs and calls notFound() for unknown slugs in both generateMetadata and the page.
  • comparison-slugs.ts (no imports) is now the one comparison list. The route, sitemap, footer, hub and llms.txt all read it, and COMPARISON_SPECS must satisfies Record<ComparisonSlug, …>. A new rival is now one spec, one footer label and one slug. Before, it took a new route file plus hand edits to the sitemap, footer JSX and llms.txt.
  • The existing five comparisons keep their copy, titles, descriptions, CTAs and JSON-LD nodes unchanged. The only addition is the breadcrumb.

Checks

  • New comparison-routes.test.ts checks all 6 rivals × 8 locales: title, description, canonical, hreflang cluster, OG URL, one h1, both entry CTAs, the breadcrumb link, and the JSON-LD types. It also checks that nonexistent, unknown-rival, mis-cased and empty slugs 404, and covers the hub's metadata in 8 locales, its links, CTAs and ItemList.
  • Updated tests: comparison-landing.test.ts (FAQ ⇄ FAQPage item for item, the breadcrumb trail, Brilliant pairing categories, no Brilliant price quoted), the SEO route table, and llms.txt.
  • Biome 2.6.4 passes on every changed file.
  • The desk remote build pool was down while I wrote this (creating the build machine: transport: request deadline exceeded), so CI is the first full run of typecheck and unit tests. A runtime smoke run of the specs, route table and llms.txt passed locally, and the existing llms.txt lines are byte-identical.

- Replace the five static /vs/<rival> wrappers with one vs/[rival] page.
  It lists every locale and slug in generateStaticParams and returns a
  real 404 for unknown slugs in both metadata and the page.
- Keep the comparison list in one import-free slug list
  (comparison-slugs.ts). The route, sitemap, footer, hub and llms.txt
  all read it, and the compiler requires one spec per slug.
- Add /vs: every comparison's own short verdict on broadsheet cards,
  with play and pricing CTAs and CollectionPage/ItemList JSON-LD.
- Add /vs/brilliant. Brilliant facts come from brilliant.org, its
  Premium page and its Help Center, read 18 Nov 2026. No Brilliant
  price is quoted because it varies by plan and offer. Tryit prices
  come from the catalogue.
- Comparison pages gain a "Compare" breadcrumb and a BreadcrumbList node.
- The footer gets a Compare column with "All comparisons" (6 locales;
  en-GB and zh-TW inherit), and llms.txt lists /vs and /vs/brilliant.
@shtse8
shtse8 enabled auto-merge November 18, 2026 14:09
@shtse8
shtse8 added this pull request to the merge queue Nov 18, 2026
Merged via the queue into main with commit 4930396 Nov 18, 2026
15 checks passed
@shtse8
shtse8 deleted the agent/tryit-vs-hub-and-brilliant branch November 18, 2026 14:56
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