mrkeyoor.com_
Wed 02 Sept 13:45 UTC
Self-Hostedevaluationupdated 02 Sept 2026

TypeWords review

TypeWords is an open-source web app for learning English vocabulary and memorizing articles through typing, dictation, and recall practice. It combines guided exercises, pronunciation, word details, and personal review lists so learners can keep study and progress data under their own control.

trackingstars / 7d
Verdict

Our build completed in 89 seconds, but the only attempted test failed in 5 seconds because TypeWords has no test script. Use it if typing, dictation, and self-hosted local data match how you study, because the feature set is unusually focused and the project was pushed just 5 days before our review. Do not treat the successful build as proof of release safety: absent CI and automated tests, careful manual checks belong in every upgrade plan.

We ran it

Install✓ · 30s1644 packages · 719 MB
Build✓ · 89s
Tests✗ · 5sran, no count parsed
Repo322 files~47,033 lines of source · 16.8 MB · 0 CI workflows

Answers from our run

Does TypeWords build from source?

Dependencies installed in 30 seconds (1644 packages), and the build succeeded in 89 seconds. We cloned commit 633e179 into a clean Debian container with 3 CPUs and no project-specific setup.

Do TypeWords's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use TypeWords?

People who need effortless cross-device sync, because standalone use requires manual backup

What are the alternatives to TypeWords?

Anki, LibreLingo, Mochi. Our build completed in 89 seconds, but the only attempted test failed in 5 seconds because TypeWords has no test script.

Setup4/5Install and build worked, but dependencies occupy 719 MB
Docs3/5Clear start guide and many translations, limited operations detail
Community4/59,201 stars, 42 open issues, and a push 5 days ago
Maturity3/5Usable build, but no test script or CI workflow

Who it’s for

English learners who remember material better by typing and dictation
Self-hosters who want an ad-free study tool with local data
Students preparing for CET-4, CET-6, GMAT, GRE, IELTS, SAT, TOEFL, or TEM exams
Learners who want both vocabulary drills and article memorization in one interface

Who it’s NOT for

People who need effortless cross-device sync, because standalone use requires manual backup
Teams that require a documented automated test suite and CI gate
Learners looking mainly for live tutoring, speaking assessment, or a full course curriculum
Operators who want an official container image or Docker-first deployment

Setup reality

In our sandbox, installation succeeded in 30 seconds and pulled 1,644 packages occupying 719 MB; the production build also succeeded in 89 seconds, but the test step failed after 5 seconds because there is no test script. The README's pnpm install and pnpm run generate path is therefore credible for getting a build, though the 719 MB dependency footprint is substantial and the absence of a runnable test command or CI workflow leaves a self-hoster to perform manual verification before deploying.

TypeWords turns recall into a typing habit

TypeWords is an English-learning web app built around typing, dictation, and recall. Instead of making every session a multiple-choice quiz, it asks learners to type, follow along, take dictation, or spell from memory. That gives the project a clearer identity than a generic flashcard clone. Its public profile is substantial at 9,201 stars, while the GPL-3.0 license keeps self-hosting and modification available under copyleft terms.

The scope covers two related jobs. Word practice includes phonetics, American and British pronunciation, example sentences, phrases, synonyms, roots, etymology, and error statistics. Article memorization supports imported material, translation, bilingual comparison, sentence-by-sentence entry, and automatic pronunciation. Version v3.0.7 is therefore a study workspace spanning isolated vocabulary and longer passages.

Its practice modes give learners meaningful choices

The strongest part is the progression between assistance and recall. Follow-along practice can establish spelling and rhythm, dictation removes the written cue, self-test raises the recall demand, and spelling from memory makes the learner produce the answer. Smart mode says it chooses learning words using memory curves, while free mode leaves the plan unrestricted. The 4 named practice modes make the learning loop concrete.

The supporting lists also fit real study behavior. Mistyped words automatically enter a wrong-word book, mastered terms can be skipped, and favorites provide a deliberate review queue. That is a sensible division between problems, completed material, and personally important items. Built-in libraries include CET-4, CET-6, GMAT, GRE, IELTS, SAT, TOEFL, Graduate English, TEM-4, and TEM-8 vocabulary, reducing preparation for exam-oriented users.

Article practice most clearly separates TypeWords from ordinary flashcards. Learners can add or import articles, view bilingual comparisons, and work sentence by sentence in follow-along or dictation mode. Listening while writing from memory ties sound, spelling, and passage structure together. The README does not establish translation quality, pronunciation accuracy, or learning outcomes, so evaluate those with 2 or 3 sample texts.

What happened when we ran it

We cloned commit 633e179 into a fresh unprivileged Debian sandbox with 3 CPUs, 8 GB of RAM, Node 22, and no secrets. The repository contained 322 files, about 47,033 lines of source, and occupied 16.8 MB when checked out. Installation succeeded in 30 seconds, bringing in 1,644 packages and using 719 MB on disk. That is a successful setup, but also a large dependency tree for a focused learning app.

The build succeeded in 89 seconds, which supports the README's basic pnpm setup claims. The test step failed in 5 seconds with ERR_PNPM_NO_SCRIPT: the package has no test script. The log does not show failing assertions or an environment problem, only that the command is absent. We also found 0 CI workflow files, no Dockerfile, no tests directory, and a monorepo workspace layout. Our run therefore proves the checked commit can install and build on this box, not that its behavior is covered by automated regression tests.

Self-hosting is approachable, but operations are under-documented

The README gives a short path: install Node.js, clone with depth 1, run pnpm install, start development on port 5567, and use pnpm run generate for project files. It also warns that GitHub's Download ZIP will not work properly. Those details are useful and more honest than a vague build badge, yet they stop before production operations. There is no provided Dockerfile, so administrators must choose their own web server, process, update, backup, and rollback arrangement.

Data can be saved locally when running standalone, which keeps the service simple and avoids a mandatory account platform. The tradeoff is explicit: switching devices requires manual backup. Before relying on TypeWords as a daily study record, verify export and restoration with a disposable profile, document where data lives, and test the site on the browsers you actually use. With 719 MB of installed packages and no automated test command, pinning a known-good commit is more prudent than blindly updating every push.

Active development offsets some maturity concerns

The latest tagged release is v3.0.7 from June 17, 2026, while the last push was August 28, only 5 days before this review. Taken together, those dates indicate continuing work even though a newer release tag was not shown. The 42 open issues are noticeable but not alarming for a project with 9,201 stars; the supplied data does not reveal response times, closure rates, or maintainer count, so it cannot support stronger claims about issue handling.

Documentation is unusually accessible at the top level, with English plus 13 translated README links covering Spanish, German, French, Portuguese, Russian, Ukrainian, Japanese, Korean, Thai, Vietnamese, Indonesian, Traditional Chinese, and Simplified Chinese. Contributor guidance exists, and maintainers ask contributors to coordinate before coding to avoid conflicts. What is missing is operational depth: supported Node and pnpm versions, deployment recipes, upgrade notes, data migration guidance, and a visible quality gate would make v3 deployments easier to trust.

It belongs beside, not beneath, your core learning records

TypeWords fits best as a personal web app served behind an existing HTTPS reverse proxy, with browser data included in a regular backup routine. It can be the main practice surface for vocabulary and memorized passages, but users who already depend on a mature spaced-repetition collection should migrate gradually. Start with 1 vocabulary set and 1 article, confirm pronunciation and import behavior, then decide whether the typing workflow earns a permanent place.

Choose Anki when card scheduling, add-ons, and multi-device history are the priority. Choose LibreLingo when you need a structured course rather than a practice surface. TypeWords is the more interesting pick when keyboard-driven recall itself is the desired habit. Its successful build, recent push, ad-free design, and rich practice modes make it worth trying; its missing test script and thin deployment guidance keep it short of an automatic recommendation for unattended production use.

Alternatives

ProjectWhat it isPick it when
AnkiA mature spaced-repetition system with desktop, mobile, and web-sync options.Pick this instead when scheduling depth, add-ons, and a large flashcard ecosystem matter more than typing-focused lessons.
LibreLingoAn open-source platform for building and taking structured language courses.Pick this instead when you want course progression across language skills rather than concentrated English typing practice.
MochiA note-centered spaced-repetition app that turns connected writing into review cards.Pick this instead when your study workflow starts with notes and custom flashcards rather than supplied word lists and articles.

What people are saying

  1. [github-trending] zyronon/TypeWords

Sources

  1. TypeWords GitHub repository
  2. TypeWords homepage

More self-hosted reviews

openwrt · koreader · linera-protocol · headscale · v2 · OpenShell · the whole board →