0161. The public name is Duolith
- Status: Accepted (Mik, 18 Nov 2026); the rename below is done, apart from the repository's address on GitHub
- Date: 2026-11-18
- Decided by: Mik
- Planning item: D1, D2
Context
Decision 0010 made "strata" a codename that must never reach a registry, and decision 0091 left every public name as a placeholder until Mik chose one. "strata" could not be kept: @strata and @stratajs on npm, the strata crate and github.com/strata belong to others, and a C UI framework and an MCP server already use the name.
Mik chose between two finalists on 18 Nov 2026, after rejecting descriptive compounds (NativePages), Astro blends (Nastro, because Astro is a trademark now owned by Cloudflare), and common English words (none is free as a bare npm name).
Decision
- The public name is Duolith: "two from one stone", one source that becomes a website and native apps. It is written
Duolithin titles andduolithwherever a command, package or id needs one word. - It was free on every channel checked on 18 Nov 2026: | Channel | Name | Result | | --- | --- | --- | | npm package |
duolith| free | | npm scope |@duolith| free | | crates.io |duolith,duolith-cli| free | | GitHub |duolith| free | | Domains | duolith.dev, duolith.io | free (duolith.com is taken) | | Web search for a tool, product or company of the same name | | none found | Not checked: the VS Code Marketplace, Open VSX and JetBrains Marketplace publisher ids, and trademarks. A trademark search comes before the first publish. - **The page-file extension is
.duo.** Mik chose it over.duolithon 18 Nov 2026: a page isindex.duo. It replaces the provisional.stratain the rename, together with the language id. - **The command is
duolith, andduois a short name people add themselves.** On 19 Nov 2026 Mik choseduolithwithduoas a short alias, and then, on learning that GitLab's Duo CLI (@gitlab/duo-cli) installs aduocommand, chose to make it opt-in. Releases ship onlyduolith, and the docs, messages and generated files sayduolith. The guide shows the one-line shell alias (projects.md), so nothing Duolith installs can take the place of another tool's command. - Nothing is registered or published by this record. Registering the npm scope, the crate names, the GitHub organisation and the domains needs Mik's accounts, and decision 0091's dry run stays in force until he adds the publish job.
Needs Mik
- Registering the names in his own accounts: the
@duolithnpm scope and the bareduolithpackage, theduolithandduolith-clicrates, theduolithGitHub organisation, and duolith.dev and duolith.io. Availability changes daily, so this is worth doing first. - The VS Code publisher and the extension's name. Recommended: publisher
duolith, extensionduolith-vscode, once the publisher id is confirmed free. - A trademark search before the first publish.
The rename
The rename is one change, as decision 0010 requires. Mik asked for it on 18 Nov 2026 and steps 1 to 4 are done; where they went beyond this list is under What the rename did.
tools/release/release.yaml:product: duolith,display-name: Duolith,scope: "@duolith", the publisher and extension name, and the docs domain in place ofdocs.example.invalid.- The uses of the codename that staging keeps today (listed by
pnpm release:dry), together with the code that reads them: the language id, the page-file extension (.stratabecomes.duo), the extension's setting and command ids, and the module names pages import from (@strata/clientbecomes@duolith/client). - Crates
strata-*toduolith-*, workspace packages@strata/*to@duolith/*, thestratacommand toduolith,strata.yamltoduolith.yaml, and diagnostics, docs, skills, packs, examples and generated files regenerated fromspec/. tools/release/codename.tsand its--strictcheck are removed, since no codename is left to rewrite.- The repository is renamed on GitHub (GitHub redirects the old address).
About 2,000 files mention the codename, so the change is mechanical but large, and it is verified by the full CI run and the conformance fixtures.
What the rename did
- Language id and scopes. The language id is
duolith(editors, the language server, code fences) and TextMate scopes end in.duolith; only the file extension is the short.duo. - Names that follow from the name. The hidden project folder is
.duolith/, the output folder_duolith/, environment variables startDUOLITH_, and the development app ids aredev.duolith.*, after duolith.dev. - Grammar and highlighter packages. The placeholders of decision 0100 became
@duolith/shiki,@duolith/highlightjs,@duolith/prismandtree-sitter-duolith(npm and crate), and the language's display name is Duolith. - Provisional, for Mik to confirm when he registers them: the VS Code publisher
duolithand extensionduolith-vscode, and the JetBrains plugin iddev.duolith.jetbrainswith the vendor "Duolith contributors". - Not changed: the docs address
duolith explainprints is still the reserveddocs.example.invaliduntil the site has its address, and the repository's address on GitHub stays until Mik renames it (step 5). - Kept as history: decisions 0010 and 0091 and this record still say "strata" where they describe the codename. Every other record was rewritten with the rest of the repository, so its file names and commands match what a reader finds today.
Alternatives considered
| Option | Why not |
|---|---|
| Gemall (Mik's spelling of "gimmal", two linked rings) | The other finalist. gemall on GitHub and gemall.io are taken, it can be read as "gem mall", and "gem" suggests Ruby gems or Gemini. |
| Keep "strata" | Taken on npm, crates.io and GitHub, and already used by other developer tools. |
| NativePages and other descriptive compounds | Free everywhere, but Mik found them flat. |
| Nastro and other Astro blends | Built on a trademark in the same market. |
Installing a duo command beside duolith | It is what Mik types, but GitLab's Duo CLI installs a command of the same name, and whichever came first on the search path would win. An alias a person adds is their own choice. |
.duolith as the extension | Names the framework in full, as .astro and .svelte do, but Mik preferred the shorter .duo. |
| A common English word (Hoist, Spry, Cinch) | No such word is free as a bare npm name, so each needs a js suffix on some channel. |
Consequences
- This record supersedes decision 0010's codename and its provisional
.strataextension. Both stay in the repository until the rename. .duois short enough that another tool could claim it; editors pick a language by extension, so the editor shells must register it clearly.- Decision 0091's placeholders can be filled in, by the rename and not before.
- Until the names are registered, someone else can still take them.