mydictionary.org
The website for My Dictionary, served by GitHub Pages from
main (CNAME → mydictionary.org). Pushing to main deploys it.
It lives as the MyDictionaryWebsite/ submodule of the app repo: commit here first, then commit the
updated submodule pointer in the app repo.
Pages
| Path | What |
|---|
index.html | Landing page in the App Store story order: hero, the pain ("Looked it up. Forgot it by Friday."), Capture, Understand, Remember, Grow, Ask Pip, Mac + MCP, reviews, FAQ |
privacy-policy.html, terms-of-use.html, legal.html | Legal pages (linked from the app and App Store) |
docs/mcp/ | MCP server setup (linked from the Mac app) |
pack/, packs/, apple-app-site-association, .well-known/ | Vocabulary-pack universal links (notes in the local, git-ignored Documentation/ASSOCIATED_DOMAINS.md) |
ar/ de/ es/ fr/ hr/ ja/ ko/ ru/ uk/ | The same four pages in each language (generated) |
Languages
English plus Arabic, German, Spanish, French, Croatian, Japanese, Korean, Russian and Ukrainian,
switched with the language menu in the header. The pages are generated — don't edit the HTML:
- strings:
i18n/<lang>.json (English i18n/en.json is the source; every language has the same keys,
[[…]] marks the key phrase, set in green New York italic)
- legal page bodies:
i18n/legal/<lang>/<page>.html
- then run
python3 scripts/build_pages.py (also writes sitemap.xml and the hreflang tags)
The MCP docs page (docs/mcp/) is English only and edited by hand.
All pages share css/site.css, in the 7.0 app's language ("ink on paper"): the MDDesign palette
(paper, ink, one green; night in dark mode), heavy headlines with the key phrase in New York italic,
the app's ink objects (1.5 pt stroke, solid shadow 3 pt down), and each section on its own ground
like the App Store screenshot frames. No build step and no JavaScript besides a few inline lines.
The store badges are Apple's official localized artwork in images/badges/<lang>/ (black lockup,
white in dark mode), used unaltered: no frame, shadow or recoloring around them.
Images
images/site/*.webp are scenes made only of real 7.0 UI: iPhones with the 7.0 App Store captures
(docs/aso/screenshots/source/captures-7.0/iphone/<store>/ in the app repo) and Pip
(docs/aso/DuckPNG). Every language gets its own pictures in images/site/<lang>/ from its store's
captures; a picture that isn't built yet falls back to English. The Mac section has no picture until
there are 7.0 Mac captures.
python3 scripts/build_images.py # English and every language
python3 scripts/build_images.py ja ko # just these
Icons
favicon/, favicon.ico and the apple-touch-icon*.png files are made from the app icon's Icon Composer
exports kept in the app repo (docs/aso/icon/MyDictionaryIcon-iOS-Default.png and -Dark.png; export
them again from Shared/MyDictionaryIcon.icon when the icon changes). Tab icons keep the rounded shape and
switch to Dark in dark mode; home-screen icons are full-bleed squares.
python3 scripts/build_icons.py
Facts on the page
The rating (4.8, 101 ratings) and the three review quotes are real (App Store Connect / App Store,
October 2026). Update them from App Store Connect rather than writing new ones.
