Open-source project
hefengxian/my-ielts avatar
hefengxian/my-ielts

hefengxian/my-ielts: A Vue Study Site for IELTS Vocabulary, Grammar and the 538 Reading Paraphrases

IELTS vocabulary guide, grammar notes, Listening 179, Reading 538, synonym substitutions and more - everything compiled while preparing for my IELTS exam.

4,162 stars461 forksVueLicense varies

At a glance

What is it?
A personal IELTS study site built on Vitesse Lite, published to GitHub Pages, that packages vocabulary drills, grammar notes and exam word lists into one static app. It is a study aid, not an official IELTS service, and the licence is not stated in the repository.
Who is it for?
Adopt hefengxian/my-ielts if you want a self-hosted, offline-capable set of IELTS word lists and drills, or if you are a Vue 3 developer willing to edit src/ to add your own material. Do not adopt it if you need an official score check, a TRF download, or a speaking module, because the repository contains none of those.
Can I use it commercially?
Not without permission. GitHub finds no licence file in the repository, and without a licence all rights are reserved by default: you may read the code but not reuse it. Check the README, or ask the authors, before using it.
Is it still maintained?
Yes. The repository last received commits 90 days ago.
What is it written in?
Mainly Vue, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • hefengxian/my-ielts4,162 ★ · +667
Star history
Repository2026-09-242026-11-15
hefengxian/my-ielts3.5k4.2k

667 Stars in the last 52 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What hefengxian/my-ielts actually collects, and who it is for

This is one person's IELTS revision material, turned into a browsable site and published at https://hefengxian.github.io/my-ielts/. The README describes the scope as vocabulary, grammar, and the listening, speaking, reading and writing sections, drawn from named prep books: 雅思词汇真经 (the orange Liu Hongbo vocabulary book), 新东方雅思语法, the 179 listening test-point words, the 538 reading synonym-replacement words, and 顾家北手把手教你雅思写作 V6.0 with its 100 sentence translation exercises. The audience is narrow on purpose. It suits a self-studying candidate who already owns or follows those books and wants the word lists in a searchable, drillable form. It also suits a Vue developer who wants a ready-made shell for their own notes. It does not suit anyone looking for a general IELTS course, a mock-test engine, or anything connected to a real exam account.

The architecture: a static Vue 3 app on GitHub Pages

There is no backend and no database. The repository is a Vite build of a Vue 3 single-page application, scaffolded from Vitesse Lite, with vue-router handling the section pages and UnoCSS plus TailwindCSS-derived styling, which the README says follows Flowbite and the Flowbite Admin Dashboard. All content ships with the bundle, so the deployed site is a set of static files on GitHub Pages and works without a server. The README notes that secondary development assumes familiarity with Vue 3 and TailWindCSS, which is an honest statement of the entry cost: adding a word list means editing source files and rebuilding, not filling in a form. The package.json lists the usual Vitesse stack (unplugin-auto-import, unplugin-vue-components, unplugin-vue-macros, vite-plugin-pages), so page routes are file-based, and the test directory plus Vitest and @vue/test-utils are present for component tests. The build is pinned to pnpm 8.6.0 through the packageManager field.

Installing hefengxian/my-ielts locally and opening the vocabulary drill

The README gives three commands under its development section. Clone the repository, then install dependencies with pnpm, which the packageManager field pins to [email protected].

bash
pnpm i

Start the dev server. The dev script is defined in package.json as vite --port 3333 --open, so the browser opens on port 3333 automatically.

bash
pnpm run dev

When you are ready to publish your own copy, the build script runs vite build and produces the static output.

bash
pnpm run build

Once the dev server is up, the vocabulary section is the place to start. The README documents a word list view, a practice mode, and a typing practice mode added in 2026-03 with credit to @Tommy1109255. The grammar section offers video, 讲义 (handouts) and mind maps; the listening section covers basic concepts, exam technique and the 179 test-point words; the reading section holds the 538 synonym replacements; the writing section holds the 100 sentence translation exercises. Note that the README marks 雅思听力王语料库 as WIP and the speaking section as TODO, so those pages should not be expected to be complete.

Where the project stops: speaking, licences and the official-exam gap

Two gaps matter. The first is content coverage: the README lists 口语 as TODO, so there is no speaking material at all, and the listening corpus is marked WIP. Anyone who needs speaking practice will have to look elsewhere. The second is licensing. The repository metadata gives no licence, and the README ends with a blunt instruction not to use the project for any commercial purpose. With no LICENSE file visible in the top-level entries, the default position is that the author retains rights, so redistribution, rebranding or bundling into a paid product is not something the repository grants. That restriction is a real constraint for a tutoring business or an internal training platform, even though the code itself is a standard Vite scaffold. The third point is conceptual: nothing here connects to an exam account, so it cannot check a score, download a TRF, or verify a result. Those searches belong to the official British Council or IDP services, not to this repository.

How it compares with Anki decks and Quizlet sets

The obvious alternative for the same job is a spaced-repetition tool: an Anki deck built from the vocabulary book, or a Quizlet set of the 538 reading synonyms. The difference is in the mechanism. Anki and Quizlet schedule reviews with an algorithm and sync across devices; hefengxian/my-ielts presents the material as fixed pages with a practice mode and a typing mode, and it does not implement scheduling. What this project offers instead is structure that a generic deck does not: the vocabulary is grouped by the book's 逻辑词群记忆法 (logical word-group memory method), the listening words are separated as the 179 test-point set, and the reading words are presented as synonym replacements, which mirrors how the reading section actually tests them. If your problem is retention over weeks, a spaced-repetition deck is the better tool. If your problem is that the material is scattered across books and PDFs and you want one place to browse it, this project is the more direct fit.

Maintenance and upgrade cost

The last push to the master branch was on 2026-08-17, so the repository has recent activity, and it is not archived. That is all the maintenance signal available here; the repository has no published releases, so versioning is by commit. The upgrade surface is the Vitesse Lite stack: Vite 4, Vue 3.3, TypeScript 5.1, UnoCSS 0.53 and the unplugin family, all pinned with caret ranges in package.json. The repository includes a taze-based upgrade script, pnpm run up, which runs taze major -I to move dependencies to new major versions interactively. That is a convenience, but major bumps across Vite, UnoCSS and the unplugin packages are exactly the kind of change that breaks a scaffold, so a fork that intends to stay current should run pnpm run lint, pnpm run typecheck and pnpm test after any upgrade. Because the app is static and has no server, hosting cost is effectively zero on GitHub Pages; the real cost is the time to port content if the upstream layout changes.

FAQ

See the faq field for the questions this project can and cannot answer. Several common searches about checking IELTS results, downloading a TRF or adding a score to LinkedIn are about the official exam services, not about this repository, and are therefore not covered here.

Editorial conclusion

Adopt hefengxian/my-ielts if you want a self-hosted, offline-capable set of IELTS word lists and drills, or if you are a Vue 3 developer willing to edit src/ to add your own material. Do not adopt it if you need an official score check, a TRF download, or a speaking module, because the repository contains none of those. Before cloning, read the README's non-commercial restriction and confirm the licence position with the author, then run pnpm i and pnpm run dev to see whether the vocabulary and 538 paraphrase pages match the material you actually study from.

Frequently asked questions

What is hefengxian/my-ielts?

It is a personal IELTS preparation site built as a Vue 3 single-page app and published on GitHub Pages, collecting vocabulary, grammar, listening, reading and writing material from named prep books. The README lists the 雅思词汇真经 vocabulary book, 新东方雅思语法, the 179 listening test-point words, the 538 reading synonym replacements and the 100 sentence writing translation exercises.

How do I run hefengxian/my-ielts locally?

The README gives three commands: pnpm i to install dependencies, pnpm run dev to start the dev server, and pnpm run build to build. The dev script is defined as vite --port 3333 --open, so the site opens on port 3333.

Does hefengxian/my-ielts include speaking practice?

No. The README lists the speaking section as TODO, and it also marks the 雅思听力王语料库 listening corpus as WIP, so those parts are incomplete.

Can I use hefengxian/my-ielts commercially?

The README states that the project must not be used for any commercial purpose, and the repository metadata does not state a licence. Treat the material as restricted to personal study unless the author says otherwise.

Official sources

  1. hefengxian/my-ielts on GitHub
  2. Issues
  3. Project website
  4. README
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/hefengxian-my-ielts.svg)](https://hysenlabs.com/projects/hefengxian-my-ielts)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/hefengxian-my-ielts.svg)](https://hysenlabs.com/projects/hefengxian-my-ielts)

Was this useful?