Guide

Live website design reference

This page is a visual board for the real Hanzify components. Use it to compare badges, HSK chips, dashboard cards, buttons, panels, and supporting UI while you design and tune the website.

User Levels

Avatar badge levels

Badge-only reference rows for learner rank and subscription state, using the same visual language as the profile area near the avatar.

Learner rank badges

One line, one badge, so you can judge spacing, color, and wording cleanly.

NewbieHSK 1 starting point
ElementaryHSK 2 everyday learner
IntermediateHSK 3-4 steady reader
Upper IntermediateHSK 4 stronger independence
AdvancedHSK 5 dense reading
MasterHSK 6 high command
ExpertHSK 7-9 near-native band

Subscription badges

Subscription state reference badges for account and billing surfaces.

FREEFree user plan
PRORecurring Pro plan
LIFETIME PROOne-time permanent Pro access

Page reading levels

These map the page to the dominant HSK band. Higher bands are promoted when they cover at least 20% of the page.

Beginner HSK 1-2

Fallback level if no higher band reaches 20% of the page.

Intermediate HSK 3-4

Assigned when HSK 3-4 words are at least 20% of the page.

Advanced HSK 5-6

Assigned when HSK 5-6 words are at least 20% of the page.

Native HSK 7-9

Assigned when HSK 7-9 words are at least 20% of the page.

Reading difficulty by comprehension

These labels come from the page comprehension percentage in the reading analysis logic.

Alien Language 0-10%

Almost everything is unfamiliar, so the page will feel unreadable.

Recognizing a Few Words 11-25%

You can pick out isolated words, but not enough to follow full meaning yet.

Starting to Recognize Patterns 26-40%

Repeated structures begin to stand out, even though much of the page is still new.

Heavy Effort 41-60%

You can follow parts of the page, but reading still takes sustained work.

Stretch Zone 61-70%

This is challenging but manageable, with enough context to keep pushing through.

Comfortable Reading 71-85%

You can read with a good sense of flow and only occasional interruptions.

Smooth Reading 86-100%

Most of the page reads naturally, with minimal lookup or friction.

Popup guidance cards

Reference for the informative feedback blocks inside the floating popup after reading analysis.

Good level for learning
You can follow the page while still meeting enough new words to make steady progress.
This page may be a bit advanced for now.
Suggestions: • Try easier stories • Review unknown words first
Too hard right now
Try a lower-level page first, then return after building more known words and characters.
HSK System

Starter chips, HSK cards, and progress bars

This area shows the HSK badges by themselves first, then the broader HSK card and progress system used across the website.

HSK badges

One line, one HSK badge, matching the chip system used in the starter selector.

HSK 1Core beginner words
HSK 2Daily vocabulary expansion
HSK 3Connected reading layer
HSK 4Independent reading level
HSK 5Advanced article band
HSK 6Nuanced native-style input
HSK 7-9Academic and specialist band

Do you know any of those characters?

Starter HSK selection chips and starter options for quick visual reference.

Characters

Words

Learning profile items

Vocabulary progress 330 / 600 words
Daily goal 10 minutes
Known words 149
Reading score 57%

HSK colors overview

HSK 1 Starter Warm red beginner level
HSK 2 Daily Green daily vocabulary layer
HSK 3 Connected Amber practical reading level
HSK 4 Independent Blue stronger reading level
HSK 5 Dense Purple advanced vocabulary
HSK 6 Nuanced Brown higher native-style reading
HSK 7-9 Native Rose expert and specialist reading
HSK 1174 / 174
100%
HSK 2173 / 173
100%
HSK 38 / 270
3%
HSK 40 / 447
0%
HSK 50 / 772
0%
HSK 60 / 1100
0%
HSK 7-90 / 3000
0%

HSK highlight colors

Live-reading style preview with pinyin above the word and the same underline-style HSK highlighting used on page.

每天měi tiān 学习xué xí 新闻xīn wén 报道bào dào 语境yǔ jìng 迁徙qiān xǐ 算法suàn fǎ
HSK 1Warm red highlight
HSK 2Green daily layer
HSK 3Amber connected reading
HSK 4Blue independent reading
HSK 5Purple dense vocabulary
HSK 6Brown nuanced reading
HSK 7-9Rose native-level band
Non-HSKNeutral out-of-band vocabulary
UI Elements

Buttons, pills, metrics, and dashboard blocks

These are the smaller UI pieces that show up repeatedly across the website and dashboard surfaces.

Buttons and utility pills

Primary and secondary action patterns, plus small tags used across cards and supporting content.

Default pill Soft pill Danger pill Tag

Info card

Light informational card for explanatory text, product notes, and supporting detail beside darker feature surfaces.

Resource card

Reference card with the same rounded surface language used for resources, support content, and secondary product explanations.

Cards

Feature and support card references

These examples let you compare the darker feature surface against lighter informational cards in the same page.

Reader flow

Instant translation

Context-aware help without breaking the reading rhythm.

上下文 meaning inline
Difficulty map

HSK highlighting

See level spread, density, and page feel before you commit to the read.

HSK 1 HSK 3 HSK 5 HSK 6+
Memory loop

Vocabulary saving

Capture words from the web and feed them back into review.

认识 继续 review queue

Feature-level pills

These are the home-page legend chips used in the feature grid.

HSK 1 HSK 3 HSK 5 HSK 6+
ni3 hao3 认识 继续 上下文