AT Mot — a bilingual (EN/FR) daily word game native to the AT Protocol.
Merge remote-tracking branch 'origin/trunk' into add/obfuscate-answers
# Conflicts:
# DECISIONS.md
author
Jeremy Herve
date
(Jun 25, 2026, 12:56 AM +0200)
commit
8595b5c8
8595b5c8d5f08d18b59710c28435de2a6bf13ced
parent
7476fcf0
7476fcf010fd3ed426dfc33c60373bdfd3a83bf8
+41
-84
+25
-34
DECISIONS.md
+25
-34
DECISIONS.md
···
25
25
26
26
4. **Sources:** English dictionary = **ENABLE** (Public Domain); French dictionary =
27
27
**an-array-of-french-words** (MIT); commonness ranking for both = **hermitdave/FrequencyWords**
28
-
(MIT, OpenSubtitles). The French list is sourced independently with **no relation to** the
29
-
`wordle-fr` / “Le Mot” project, as required.
28
+
(MIT, OpenSubtitles).
30
29
31
30
5. **Validity vs. commonness are separated.** Frequency lists alone leak proper nouns, foreign
32
31
words, and apostrophe-mangled contraction fragments. So the *dictionary* decides validity and the
···
66
65
67
66
## Design
68
67
69
-
12. **Type = Overused Grotesk (display/body) + IBM Plex Mono (data/provenance)** — the exact
70
-
skypress.blog stack, self-hosted (both OFL).
68
+
12. **Type = Overused Grotesk (display/body) + IBM Plex Mono (data/provenance)**, self-hosted
69
+
(both OFL).
71
70
72
71
13. **Board palette:** teal `#0F766E` (correct), burnt amber `#B45309` (present), slate `#5B6776`
73
-
(absent) — deliberately not Wordle's green/yellow. The same saturated chips are used in both
72
+
(absent). The same saturated chips are used in both
74
73
light and dark themes, which guarantees AA contrast for the white tile letters in either theme.
75
74
Secondary non-hue cue: an inner ring on "present" tiles plus per-tile aria labels announcing the
76
75
state, so colour-blind and screen-reader players read the board clearly. The shared emoji grid
···
95
94
96
95
## Tooling
97
96
98
-
18. **Dev tooling (Vite/Vitest) bumped to latest majors** to clear all `npm audit` advisories
99
-
(currently **0 vulnerabilities**). The advisories were dev-server-only (esbuild), never in
100
-
shipped code.
97
+
18. **Dev tooling (Vite/Vitest) bumped to latest majors** to clear all `npm audit` advisories. The
98
+
advisories were dev-server-only (esbuild), never in shipped code.
101
99
102
100
19. **atcute versions:** `@atcute/client@^5`, `@atcute/oauth-browser-client@^4`,
103
101
`@atcute/identity-resolver@^2` (newer than the spec's illustrative snippets; the API used is
104
102
equivalent).
105
103
104
+
## PWA / installability
105
+
106
+
20. **Manifest-only PWA — deliberately no service worker.** The app is installable
107
+
to the home screen via `public/manifest.webmanifest` + committed PNG icons
108
+
(rasterized once from `icon.svg`, flattened onto `#0e1116`) + apple/mobile
109
+
web-app meta tags. There is intentionally **no service worker and no caching
110
+
layer**: this is a daily game with dynamic reads (Constellation leaderboard,
111
+
PDS writes, OAuth), and an over-eager cache is exactly what would serve a
112
+
stale puzzle or stale bundle. Consequence: iOS add-to-home-screen and
113
+
Android manual "Add to Home Screen" both work from the manifest alone; the
114
+
proactive Android install banner (which needs a service worker) is forgone on
115
+
purpose. Loading speed is unchanged (CDN + ~94 KB bundle) with no new failure
116
+
modes. The regression guard `tests/pwa.test.ts` uses `node:*` imports, so
117
+
`"node"` was added to the shared `tsconfig.json` `types` allowlist — a
118
+
conscious trade-off: Node globals become visible to `src/` typechecking, but
119
+
`noEmit` + Vite bundling mean it can't affect runtime; narrow later by giving
120
+
`tests` its own node-typed project if that boundary is wanted.
121
+
106
122
## Anti-cheat
107
123
108
-
22. **The daily-answer sequence ships obfuscated, not in plaintext.** The ordered
124
+
21. **The daily-answer sequence ships obfuscated, not in plaintext.** The ordered
109
125
`answers` array used to ship as plain English words, so anyone could open the
110
126
JSON (in the repo or the JS bundle / network tab), find their puzzle number,
111
127
and read today's — or any future day's — word. It now ships as `answersEnc`:
···
123
139
reveals no day mapping); (b) French answer words that carry accents remain
124
140
individually visible as keys in the plaintext `accents` display map — but not
125
141
their day-order, so the daily mapping stays hidden.
126
-
127
-
## Handoff note
128
-
129
-
20. **No git remote is configured.** Everything is committed to the **`trunk`** branch, which is the
130
-
repository's current/default branch locally (HEAD points at it). Creating a remote and marking
131
-
`trunk` as the default branch *on the host* (GitHub/Tangled/etc.) is a one-step manual action for
132
-
the owner, since no remote exists to push to yet.
133
-
134
-
## PWA / installability
135
-
136
-
21. **Manifest-only PWA — deliberately no service worker.** The app is installable
137
-
to the home screen via `public/manifest.webmanifest` + committed PNG icons
138
-
(rasterized once from `icon.svg`, flattened onto `#0e1116`) + apple/mobile
139
-
web-app meta tags. There is intentionally **no service worker and no caching
140
-
layer**: this is a daily game with dynamic reads (Constellation leaderboard,
141
-
PDS writes, OAuth), and an over-eager cache is exactly what would serve a
142
-
stale puzzle or stale bundle. Consequence: iOS add-to-home-screen and
143
-
Android manual "Add to Home Screen" both work from the manifest alone; the
144
-
proactive Android install banner (which needs a service worker) is forgone on
145
-
purpose. Loading speed is unchanged (CDN + ~94 KB bundle) with no new failure
146
-
modes. The regression guard `tests/pwa.test.ts` uses `node:*` imports, so
147
-
`"node"` was added to the shared `tsconfig.json` `types` allowlist — a
148
-
conscious trade-off: Node globals become visible to `src/` typechecking, but
149
-
`noEmit` + Vite bundling mean it can't affect runtime; narrow later by giving
150
-
`tests` its own node-typed project if that boundary is wanted.
+1
-5
NOTICE.md
+1
-5
NOTICE.md
···
13
13
- **hermitdave/FrequencyWords** — English & French commonness ranking (OpenSubtitles).
14
14
Source: <https://github.com/hermitdave/FrequencyWords>. **MIT** © Hermit Dave.
15
15
16
-
The French list is sourced independently and has no relation to, and reuses no code or data from,
17
-
the `wordle-fr` / “Le Mot” project.
18
-
19
16
## Fonts (bundled in `public/fonts/`)
20
17
21
18
- **Overused Grotesk** (`OverusedGrotesk-VF.woff2`).
···
23
20
- **IBM Plex Mono** (`ibm-plex-mono-latin-*.woff2`).
24
21
By IBM. **SIL Open Font License 1.1.** <https://github.com/IBM/plex>
25
22
26
-
These match the typography of [skypress.blog](https://skypress.blog) for family consistency across
27
-
the author's properties. Both are OFL-licensed and freely redistributable.
23
+
Both are OFL-licensed and freely redistributable.
28
24
29
25
## Runtime dependencies
30
26
+5
-15
README.md
+5
-15
README.md
···
3
3
**A bilingual (English / French) daily word game, native to the [AT Protocol](https://atproto.com).**
4
4
Guess the hidden five-letter word in six tries. Your results live in **your own PDS**, and the
5
5
leaderboard is read from the public **[Constellation](https://constellation.microcosm.blue)**
6
-
backlink index — there is **no application database and no bespoke backend.**
6
+
backlink index.
7
7
8
8
🌐 **[atmot.herve.bzh](https://atmot.herve.bzh)**
9
9
···
11
11
12
12
---
13
13
14
-
## Why it's interesting
15
-
16
-
AT Mot is a working example of the **“data on your PDS, reads via Constellation, no AppView”**
17
-
architecture for atproto apps:
14
+
AT Mot uses a **”data on your PDS, reads via Constellation, no AppView”** architecture for atproto
15
+
apps:
18
16
19
17
- **Your data is yours.** Each finished puzzle is written as a `bzh.herve.atmot.result` record to
20
18
your repo via browser OAuth. There is no server storing your games — there is no server.
···
26
24
gets the same word on the same calendar day, with no server in the loop.
27
25
- **Standards-conformant lexicons** under the `bzh.herve.atmot.*` authority, following the
28
26
[Lexicon Style Guide](https://atproto.com/guides/lexicon-style-guide).
29
-
- **Installs to your home screen, no strings attached.** A web manifest makes it installable as a
30
-
standalone app — with **no service worker and no caching**, so there's none of the stale-content
31
-
machinery that fights against a daily game whose reads are always live.
32
-
33
-
It is **not** a clone of any commercial word game: it ships its own word lists, its own brand and
34
-
look-and-feel (a sky/atproto-leaning **teal / amber / slate** board palette, deliberately distinct),
35
-
and its own lexicons. The five-in-a-row word-guessing mechanic is generic; the implementation,
36
-
data, and design here are original.
27
+
- **Installable to your home screen.** A web manifest makes it installable as a standalone app.
37
28
38
29
## Architecture at a glance
39
30
···
96
87
| English | [ENABLE](https://github.com/dolph/dictionary) — **Public Domain** | hermitdave/FrequencyWords (MIT) |
97
88
| French | [an-array-of-french-words](https://github.com/words/an-array-of-french-words) — **MIT** | hermitdave/FrequencyWords (MIT) |
98
89
99
-
The French list is sourced **independently** and has **no relation to** the `wordle-fr` / “Le Mot”
100
-
project. Lists are generated by `npm run build:words` and committed (the generated JSON _is_ the game
90
+
Lists are generated by `npm run build:words` and committed (the generated JSON _is_ the game
101
91
content); the build is reproducible (same sources + fixed seeds → identical output).
102
92
103
93
## Develop
-3
src/i18n.ts
-3
src/i18n.ts
···
45
45
backToGame: string;
46
46
langName: string;
47
47
about: string;
48
-
sourceCode: string;
49
48
profile: string;
50
49
}
51
50
···
97
96
backToGame: 'Back to today’s game',
98
97
langName: 'English',
99
98
about: 'About',
100
-
sourceCode: 'Source code on tangled.org',
101
99
profile: '@jeremy.herve.bzh on Bluesky',
102
100
};
103
101
···
149
147
backToGame: 'Retour au mot du jour',
150
148
langName: 'Français',
151
149
about: 'À propos',
152
-
sourceCode: 'Code source sur tangled.org',
153
150
profile: '@jeremy.herve.bzh sur Bluesky',
154
151
};
155
152