mozilong/TypeWords

Learn English, one keystroke at a time; smarter memorization, more efficient learning - an open-source word and article practice tool

Online Access

https://typewords.cc

Features

Word Practice

Practice modes: Follow-along / Dictation / Self-test / Spelling from memory
Smart mode: Automatically calculates learning words based on memory curves, deepening memory through dictation
Free mode: No restrictions, plan your own learning
Provides phonetics, pronunciation (American/British), example sentences, phrases, synonyms, root words, etymology, error statistics, and more

Article Memorization

Built-in classic textbooks; you can also add or import articles with one-click translation and bilingual comparison
Follow-along + dictation dual modes, sentence-by-sentence input with automatic pronunciation for more efficient memorization
Supports listening while writing from memory to reinforce learning

Favorites, Wrong Words, Mastered

Words typed incorrectly while learning are automatically added to your wrong word book for later review
Actively add words to mastered to automatically skip them in future sessions
Add words to favorites for consolidation and review

Highly Customizable

Rich keyboard sound effects
Customizable shortcuts
Highly configurable settings

Clean and Efficient

Clean design, modern UI, ad-free
Refreshing interface, simple operation
No forced subscription to any platform

Vocabulary Library

Built-in commonly used vocabulary including CET-4, CET-6, GMAT, GRE, IELTS, SAT, TOEFL, Graduate English, TEM-4, TEM-8, and more. Designed to meet most users’ vocabulary learning needs. Community contributions of additional vocabulary are welcome.

Running the Project

Note: This project can run standalone with data saved locally. Manual backup is required when switching devices; this does not affect normal usage.

Option 1: Running from Source

This project is built with Nuxt and requires a Node.js environment.

Install NodeJS, refer to the official documentation
The project is large. It’s recommended to use git clone --depth 1 https://github.com/zyronon/TypeWords.git to clone only the latest commit. GitHub’s Download ZIP feature will not work properly.
In the project root directory, open a terminal and run pnpm install to download dependencies.
Run pnpm run dev to start the project. The default address is http://localhost:5567
Open http://localhost:5567 in your browser to access the project.
Run pnpm run generate to build the project files.

Option 2: Using Docker

The easiest way to run TypeWords is using Docker:

# Pull the image from Docker Hub
docker pull zyronon/typewords:latest

# Run the container
docker run -d -p 3000:80 --name typewords zyronon/typewords:latest

Then open http://localhost:3000 in your browser to access the project.

Or use Docker Compose:

# Start with docker-compose
docker-compose up -d

# Stop the service
docker-compose down

Or build and run locally:

# Build the Docker image
docker build -t typewords .

# Run the container
docker run -d -p 3000:80 --name typewords typewords

Features and Suggestions

The project is currently in early development, with new features being added continuously. If you have any suggestions or feature requests, feel free to open an Issue. If you like the design philosophy of this software, please submit a PR. Thank you for your support!

Contributing Guide

Contributing Guidelines

If you’re interested in this project, we welcome your contributions and will provide as much help as possible.

Before contributing, please communicate with the developers to avoid code conflicts.

Thank you again for your contributions!