hefengxian/my-ielts: A Vue3 Web App for IELTS Study Resources

What hefengxian/my-ielts Collects and Who Uses It

This repository is a personal IELTS preparation tool built by a developer for their own exam study. The README describes it as covering vocabulary, grammar, and the most well-known resources for listening, reading, and writing sections of the IELTS exam. It is deployed as a static Vue3 application hosted on GitHub Pages at hefengxian.github.io/my-ielts/#/.

The primary audience is Chinese-language IELTS candidates who use the standard Chinese-market study books. The vocabulary section draws from Liu Hongbo's orange vocabulary book (雅思词汇真经), the grammar section from New Oriental's IELTS grammar course (新东方雅思语法), and the writing section from Gu Jiabei's IELTS writing guide V6.0 (顾家北手把手教你雅思写作). These are widely used Chinese IELTS preparation resources, and the app provides a digital interface for drilling their content rather than reading from print.

The README explicitly prohibits using the project for any commercial purpose.

Running the App Locally

The project uses pnpm for package management and Vite as the build tool. To set it up:

# 安装依赖
pnpm i

# 开发模式
pnpm run dev

# 构建
pnpm run build

The development server starts at port 3333, as specified in the package.json scripts ('vite --port 3333 --open'). The build command produces a static site suitable for deployment to GitHub Pages or any static host.

The project is based on the Vitesse Lite template and uses Vue 3, Vue Router 4, UnoCSS (a utility-first CSS engine), and VueUse for composables. The README notes that secondary development requires familiarity with Vue 3 and TailwindCSS conventions. TypeScript is used throughout, with type checking available via the typecheck script in package.json.

Vocabulary Section: Flashcards and Typing Practice

The vocabulary section is the most developed part of the app. It contains content from Liu Hongbo's IELTS core vocabulary organized using the logical word-group memorization method described in the book. The README also mentions the original audio from the book is included.

There are two study modes: a list view showing the vocabulary, and a practice mode for drilling words. A typing practice mode was added in 2026-03, contributed by a community member. This mode requires the user to type each word, which provides a different kind of recall practice compared to recognition-based flashcard review.

The README shows screenshots of the vocabulary list and the training mode interface, indicating that the app has a light and dark theme that responds to the system preference.

Grammar, Listening, Reading, and Writing Sections

The grammar section covers the New Oriental IELTS grammar course, providing access to videos, lecture notes, and mind maps from that resource. The README lists these three content types under the grammar section without further detail on how many video or lecture items are included.

The listening section covers basic IELTS listening concepts and exam-taking principles, plus a list of 179 frequently tested vocabulary words (考点词). A listening vocabulary corpus from a different resource is listed as a work in progress (WIP).

The reading section contains 538 exam-point vocabulary words with synonym substitutions (同义替换). Synonym substitution is a specific IELTS reading skill where the correct answer paraphrases the passage rather than repeating its exact words, and this section drills that vocabulary set directly.

The writing section contains content from Gu Jiabei's hand-by-hand IELTS writing guide V6.0, with 100 translation exercises starting from the basics. The speaking section is listed as TODO in the README and is not currently implemented.

What Is Missing and Where the App Falls Short

The speaking section is explicitly unfinished. IELTS speaking preparation typically involves practice with a human examiner or recorded self-assessment, neither of which this app provides.

There is no simulated test environment. The app drills specific vocabulary and grammar content but does not offer timed practice tests with the structure of the actual IELTS exam. Candidates preparing for the first time may not have enough context to use these drills without prior familiarity with the exam format.

The README does not state a software license. The only licensing statement is the prohibition on commercial use. This means users who want to fork or redistribute the code should treat the rights as ambiguous and contact the author.

The content is based on specific Chinese-language study materials. Candidates who use different textbooks or who prefer English-language IELTS preparation resources will not find this app useful, because the vocabulary and grammar content is tied to specific Chinese-market publications.

Anki as an Alternative and the Technical Stack

Anki is a general-purpose spaced repetition flashcard system with a large library of IELTS vocabulary decks created by the community. The key difference is customization: Anki lets users build or download any deck and applies a spaced repetition algorithm that optimizes review timing for long-term retention. hefengxian/my-ielts has fixed content derived from specific books, no spaced repetition algorithm, and a typing practice mode that Anki does not natively provide.

Anki works offline on all platforms; hefengxian/my-ielts runs in the browser and is deployed on GitHub Pages. Candidates who want to study offline or on a native mobile app will get better results from Anki or a similar tool.

The app is built on Vue 3.3.4, Vue Router 4.2.2, VueUse 10.1.2, and Vite 4.3.9. The package manager is pnpm 8.6.0. The last push was on 2026-08-17.

Editorial conclusion

Chinese-language IELTS candidates who are already familiar with Liu Hongbo's vocabulary book, New Oriental grammar materials, or Gu Jiabei's writing exercises will find this app a convenient digital interface for those specific resources. It is not a substitute for a full IELTS preparation course: the speaking section is documented as TODO and there is no simulated test environment. Verify that the app loads correctly at hefengxian.github.io/my-ielts/#/ before relying on it, and note that the README prohibits any commercial use of the project.

Frequently asked questions

Official sources

1. hefengxian/my-ielts on GitHub
2. Issues
3. Project website
4. README