KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

vocab

★ 87 Open GitHub ↗

A serverless Chinese vocabulary building app. Sends daily vocab words at your HSK level with custom, on-demand vocab quizzes and links to example sentences.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Daily Chinese Vocab

A serverless app that sends a Chinese word as a daily email message, along with links to example sentences and auto-generated quizzes.

Chinese learners can subscribe to daily vocab words to build their vocabulary. The vocabulary by level (1-6) is from the Hanyu Shuiping Kaoshi (HSK), China's standardized Mandarin testing levels.

To subscribe, visit https://haohaotiantian.com, where you can preview sample words for each level, see past daily words, and learn more.

## Example message

![Example message](https://hhtt-static.s3.amazonaws.com/email-screenshot-wide.png)

## Architecture

You can learn about the development process and architecture decisions in this talk:
- [Getting started building your first serverless web application](https://www.youtube.com/watch?v=DdyhdnWVukc)

And in this blog post series:
- [Developing a daily Chinese vocab app](https://emshea.com/post/chinese-vocab-app)
- [Integrating DynamoDB in my Chinese vocab app](https://emshea.com/post/vocab-app-database)
- [Migrating to a serverless contact management backend](https://emshea.com/post/vocab-subscriber-backend)
- [Designing a DynamoDB data model](https://emshea.com/post/part-1-dynamodb-single-table-design)
- [Generating audio files for text with Step Functions, DynamoDB, S3, and Polly](https://emshea.com/post/generate-audio-from-text-with-step-functions-polly)

[Front end repo](https://github.com/em-shea/vocab-frontend-vue)

![Architectural diagram](https://hhtt-static.s3.amazonaws.com/vocab-app-oct-2023.drawio+(1).png)

## Roadmap

| Roadmap item | Status |
| ------------- | :-------------: |
| Store user quiz results - weekly | |
| User practice sentences | |
| User created vocab lists | |
| Make vocab lists data-driven — move them from the hardcoded `vocab_list_service` into DynamoDB as `LIST#` metadata items so new lists can be added without code changes (prerequisite for 成语 vocab list) | :heavy_check_mark: |
| 成语 vocab list | |
| Store user quiz results - daily | :heavy_check_mark: |
| Add pronunciation audio | :heavy_check_mark: |
| Add user profiles | :heavy_check_mark: |
| Auto-generated quizzes | :heavy_check_mark: |
| Build subscriber analytics QuickSight dashboard | :heavy_check_mark: |
| Add support for traditional characters | :heavy_check_mark: |
| Build interface for users to explore and export word history | :heavy_check_mark: |
| Create API to serve daily word history | :heavy_check_mark: |

vocab

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README