🧩 Hard words filter - Add a hard-words deck filter and persist the hard flag in SRS state
✅ Single-select filters - Make deck filters single-select with an All words default
🎨 Filter style alignment - Match hard-words active styling to black/white
🔁 Mutual exclusivity - Normalize stored filter state and keep deck filters mutually exclusive

SRS Fixes

🛠️ Hard flag handling - Clear hard flag on good/easy and respect the latest hard status during merges

📦 What’s Included

✅ Mobile search layout alignment with favorites
✅ Hard-words filter and persisted hard state
✅ Single-select, mutually exclusive deck filters with normalized storage
✅ SRS merge logic improvements for hard status

📞 Feedback & Support

We’d love your feedback.

Issues: Report bugs on GitHub Issues
Feature Requests: Propose ideas via GitHub Discussions
Contributions: Pull requests are welcome

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v3.1.0 Release Notes

🎉 Welcome to HanFlash v3.1.0!

This release sharpens the core search experience, introduces a new Focus page for level-specific study, and documents the new product direction in a PRD.

✨ Major Features

Search Experience

🔍 Search deck front-and-center - The homepage search now appears at the top level for faster access

Focus Mode

🎯 Focus page - A dedicated Focus page for level-specific study sessions
🧭 Navigation update - Added Focus entry to the primary navigation

Product Direction

📄 New PRD - Added docs/New_PRD.md to document the updated product direction

📦 What’s Included

✅ New Focus page and nav entry
✅ Homepage search elevated to a top-level section
✅ Updated PRD documentation

🐛 Known Limitations & Future Work

Focus flow will continue to expand with deeper analytics
Additional search refinements and filters planned

📞 Feedback & Support

We’d love your feedback.

Issues: Report bugs on GitHub Issues
Feature Requests: Propose ideas via GitHub Discussions
Contributions: Pull requests are welcome

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v3.0.0 Release Notes

🎉 Welcome to HanFlash v3.0.0!

This release delivers the full authenticated study experience, deeper mastery insights, and new compliance + download pages. It also tightens security and polishes the mobile-first UI.

✨ Major Features

Authentication & Personalization

🔐 Full auth system - Login, registration, password reset, and secure session handling
🧭 Auth-gated study actions - Study workflows are protected and replay after sign-in
🧑‍🎓 Profile management - Manage your profile and track study preferences
🏷️ User badge updates - Username/avatar display with fast refresh after auth changes

Study Insights & Mastery

📊 Mastery tracking - Progress tracking across study ratings
🧩 Insights dashboard - Study insights panel with totals and breakdowns
🥧 Mastery pie chart - Visual mastery distribution with legend and totals
🎯 Daily focus panel - Goal controls and daily focus tracking for mobile
🔎 Deck filters - Filter mastery decks and persist your preference

UI & Experience

📱 Mobile-first auth flow - Designed for small screens with bottom nav UX
🧭 Mobile header login button - Clear entry point for unauthenticated users
🧱 Desktop layout upgrades - Right-rail snapshot, two-pane layouts, sticky controls
✨ Loading skeletons - Smoother perceived performance during data fetches

Pages & Content

📥 APK download page - Dedicated download page with footer link
👥 Contributors page - New contributors page and footer integration
📄 Privacy & Terms - Compliance pages with sitemap updates

🔧 Security & Stability

🛡️ Security hardening - WAF middleware and tightened request handling
🧪 Session fixes - Improved cookie handling to avoid race conditions
♻️ Study persistence - Flashcard review history and favorites sync on login

📦 What’s Included

✅ Authenticated study workflows
✅ Mastery tracking + insights
✅ Mobile-first profile and footer experience
✅ APK download page
✅ Contributors, Privacy Policy, and Terms pages
✅ Enhanced loading and UI responsiveness

🐛 Known Limitations & Future Work

HSK levels 1–4 only (levels 5–6 coming later)
Offline mode continues to evolve
Audio pronunciation and advanced SRS tuning planned

📞 Feedback & Support

We’d love your feedback.

Issues: Report bugs on GitHub Issues
Feature Requests: Propose ideas via GitHub Discussions
Contributions: Pull requests are welcome

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v2.1.0 Release Notes

🎉 Welcome to HanFlash v2.1.0!

This release focuses on vocabulary data corrections and improvements, ensuring accuracy across all HSK levels 1-4.

✨ Major Features

Core Learning Experience

🔍 Instant Vocabulary Search - Search by Hanzi, Pinyin, or English meaning across HSK levels 1-4
📚 HSK Level Filtering - Browse vocabulary organized by difficulty level
🧠 Flashcard Mode - Hanzi-first recall with flip-to-reveal for pinyin, meanings, and usage examples
👁️ Hide/Reveal Controls - Toggle visibility of pinyin, meanings, and translations
⭐ Favorites System - Save and manage your favorite vocabulary items for quick review
📖 Study Mode - Dedicated interface for focused vocabulary practice

Reading Experience

📍 Reading Practice Hub - Continue where you left off with a dedicated dashboard
🧭 Focus Mode - Line-by-line reading with progress tracking and keyboard navigation
🎚️ Reading Preferences - Adjustable text size, line spacing, and visibility toggles
🏷️ Story Status & Filters - Save stories, mark completion, and filter by status or length
🧩 Vocabulary Bank - Key terms surfaced at the end of each story for quick review

User Experience

📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile browsers
⌨️ Keyboard Navigation - Use arrow keys (←/→) to navigate through flashcards
🎯 Mobile-First UI - Bottom navigation bar and intuitive card-based design
🔄 Session Preferences - User settings persisted using localStorage
⚡ Fast Performance - Built with Next.js for optimal speed and user experience

PWA & Accessibility

🌐 Progressive Web App - Installable on mobile and desktop devices
📍 Service Worker - Offline-ready foundations for future offline support
♿ Accessibility Improvements - Focus management and keyboard controls throughout the app
📊 SEO Optimized - Comprehensive metadata, sitemap, robots.txt, and social share images (OpenGraph & Twitter)
🎨 Loading States - Skeleton screens for better perceived performance

🔧 Technical Highlights

Recent Updates

✅ Vocabulary Data Corrections - Fixed and validated vocabulary data for HSK levels 1-4
✅ Data Validation Script - Added comprehensive validation tool for vocabulary accuracy
✅ Hanzi Characters Verified - Ensured all characters are correct across all levels
✅ Pinyin Standardization - Standardized pinyin romanization throughout the database
✅ Meaning Improvements - Enhanced and clarified English translations
✅ Example Validation - Verified example sentences for clarity and relevance

Architecture

Monolithic Design - Frontend UI, application logic, and data access in a single Next.js application
TypeScript - Full type safety across the codebase
Tailwind CSS - Utility-first styling for responsive design
JSON-Based Data - Lightweight vocabulary database for HSK 1-4

📦 What's Included

✅ Comprehensive vocabulary database for HSK levels 1-4 (corrected)
✅ Responsive UI built with React and Tailwind CSS
✅ Flashcard interface with multiple learning modes
✅ Favorites and session history tracking
✅ Spaced Repetition System (SRS) foundations
✅ PWA manifest and service worker setup
✅ Global SEO metadata and social sharing support

🐛 Known Limitations & Future Work

Current Scope

Supports HSK levels 1-4 only (levels 5-6 coming in future releases)
Vocabulary dataset includes commonly taught words for each HSK level
Data validation script available via npm run validate:data

Roadmap

[ ] HSK levels 5-6 support
[ ] User accounts and cloud sync
[ ] Spaced Repetition System (SRS) refinements
[ ] Audio pronunciation for all vocabulary
[ ] Dark mode theme
[ ] Offline mode with full vocabulary access
[ ] Community contributions for vocabulary examples

📝 Release Highlights

Features

Corrected and validated vocabulary data across all HSK levels
Improved data accuracy for Hanzi, Pinyin, meanings, and examples
Enhanced consistency in romanization and English translations

Fixes & Improvements

Fixed vocabulary character accuracy issues
Standardized pinyin romanization format
Improved English meaning clarity and relevance
Validated example sentences for context and usage

📞 Feedback & Support

We'd love to hear your feedback!

Issues: Found a bug? Report it on GitHub Issues
Feature Requests: Have an idea? Submit it as a GitHub Discussion
Contributions: Want to help? Pull requests are welcome!

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v2.0.0 Release Notes

🎉 Welcome to HanFlash v2.0.0!

This is the first stable release of HanFlash, a lightweight Chinese vocabulary learning web app for HSK levels 1-4.

✨ Major Features

Core Learning Experience

🔍 Instant Vocabulary Search - Search by Hanzi, Pinyin, or English meaning across HSK levels 1-4
📚 HSK Level Filtering - Browse vocabulary organized by difficulty level
🧠 Flashcard Mode - Hanzi-first recall with flip-to-reveal for pinyin, meanings, and usage examples
👁️ Hide/Reveal Controls - Toggle visibility of pinyin, meanings, and translations
⭐ Favorites System - Save and manage your favorite vocabulary items for quick review
📖 Study Mode - Dedicated interface for focused vocabulary practice

Reading Experience (New)

📍 Reading Practice Hub - Continue where you left off with a dedicated dashboard
🧭 Focus Mode - Line-by-line reading with progress tracking and keyboard navigation
🎚️ Reading Preferences - Adjustable text size, line spacing, and visibility toggles
🏷️ Story Status & Filters - Save stories, mark completion, and filter by status or length
🧩 Vocabulary Bank - Key terms surfaced at the end of each story for quick review

User Experience

📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile browsers
⌨️ Keyboard Navigation - Use arrow keys (←/→) to navigate through flashcards
🎯 Mobile-First UI - Bottom navigation bar and intuitive card-based design
🔄 Session Preferences - User settings persisted using localStorage
⚡ Fast Performance - Built with Next.js for optimal speed and user experience

PWA & Accessibility

🌐 Progressive Web App - Installable on mobile and desktop devices
📍 Service Worker - Offline-ready foundations for future offline support
♿ Accessibility Improvements - Focus management and keyboard controls throughout the app
📊 SEO Optimized - Comprehensive metadata, sitemap, robots.txt, and social share images (OpenGraph & Twitter)
🎨 Loading States - Skeleton screens for better perceived performance

🔧 Technical Highlights

Recent Updates

✅ Resolved TypeScript compilation errors for production builds
✅ Fixed Turbopack build errors with route config and sitemap typing
✅ Added loading skeletons and sanitized search input
✅ Improved flashcard key handling and accessibility toggles
✅ Enhanced touch event handling for mobile devices
✅ Fixed favorites event dispatch to prevent render-phase updates
✅ Added comprehensive metadata and SEO improvements
✅ Implemented HSK level selector on home page

Architecture

Monolithic Design - Frontend UI, application logic, and data access in a single Next.js application
TypeScript - Full type safety across the codebase
Tailwind CSS - Utility-first styling for responsive design
JSON-Based Data - Lightweight vocabulary database for HSK 1-4

📦 What's Included

✅ Comprehensive vocabulary database for HSK levels 1-4
✅ Responsive UI built with React and Tailwind CSS
✅ Flashcard interface with multiple learning modes
✅ Favorites and session history tracking
✅ Spaced Repetition System (SRS) foundations
✅ PWA manifest and service worker setup
✅ Global SEO metadata and social sharing support

🚀 Getting Started

Installation & Development

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm build

# Validate vocabulary data
npm run validate:data

Features to Explore

Search - Try searching for vocabulary by Hanzi, Pinyin, or English
Flashcards - Visit the flashcard page and use keyboard arrows to navigate
Favorites - Star your favorite words to build a custom study list
HSK Levels - Filter by specific HSK levels to focus your learning

🐛 Known Limitations & Future Work

Current Scope

Supports HSK levels 1-4 only (levels 5-6 coming in future releases)
Vocabulary dataset includes commonly taught words for each HSK level
Data validation script available via npm run validate:data

Roadmap

[ ] HSK levels 5-6 support
[ ] User accounts and cloud sync
[ ] Spaced Repetition System (SRS) refinements
[ ] Audio pronunciation for all vocabulary
[ ] Dark mode theme
[ ] Offline mode with full vocabulary access
[ ] Community contributions for vocabulary examples

📝 Release Highlights

Features

Stable release branding and versioned UI
Updated global metadata, sitemap, robots, and social share images
Focus-level selector for HSK 1-4 on the home page
Mobile-first redesign with bottom nav and refreshed cards
Study mode, favorites, and PWA foundations
Release notes page with in-app reading experience
Smooth flashcard transitions for flip, next, and prev

Fixes & Improvements

Resolved build errors and TypeScript compilation issues
Improved flashcard key handling, accessibility, and touch input
Sanitized malformed meanings for safer rendering

📞 Feedback & Support

We'd love to hear your feedback!

Issues: Found a bug? Report it on GitHub Issues
Feature Requests: Have an idea? Submit it as a GitHub Discussion
Contributions: Want to help? Pull requests are welcome!

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v1.0.0-beta Release Notes

🎉 Welcome to HanFlash v1.0.0-beta!

This is the first public beta release of HanFlash, a lightweight Chinese vocabulary learning web app for HSK levels 1-4.

✨ Major Features

Core Learning Experience

🔍 Instant Vocabulary Search - Search by Hanzi, Pinyin, or English meaning across HSK levels 1-4
📚 HSK Level Filtering - Browse vocabulary organized by difficulty level
🧠 Flashcard Mode - Hanzi-first recall with flip-to-reveal for pinyin, meanings, and usage examples
👁️ Hide/Reveal Controls - Toggle visibility of pinyin, meanings, and translations
⭐ Favorites System - Save and manage your favorite vocabulary items for quick review
📖 Study Mode - Dedicated interface for focused vocabulary practice

User Experience

📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile browsers
⌨️ Keyboard Navigation - Use arrow keys (←/→) to navigate through flashcards
🎯 Mobile-First UI - Bottom navigation bar and intuitive card-based design
🔄 Session Preferences - User settings persisted using localStorage
⚡ Fast Performance - Built with Next.js for optimal speed and user experience

PWA & Accessibility

🌐 Progressive Web App - Installable on mobile and desktop devices
📍 Service Worker - Offline-ready foundations for future offline support
♿ Accessibility Improvements - Focus management and keyboard controls throughout the app
📊 SEO Optimized - Comprehensive metadata, sitemap, robots.txt, and social share images (OpenGraph & Twitter)
🎨 Loading States - Skeleton screens for better perceived performance

🔧 Technical Highlights

Recent Updates

✅ Resolved TypeScript compilation errors for production builds
✅ Fixed Turbopack build errors with route config and sitemap typing
✅ Added loading skeletons and sanitized search input
✅ Improved flashcard key handling and accessibility toggles
✅ Enhanced touch event handling for mobile devices
✅ Fixed favorites event dispatch to prevent render-phase updates
✅ Added comprehensive metadata and SEO improvements
✅ Implemented HSK level selector on home page

Architecture

Monolithic Design - Frontend UI, application logic, and data access in a single Next.js application
TypeScript - Full type safety across the codebase
Tailwind CSS - Utility-first styling for responsive design
JSON-Based Data - Lightweight vocabulary database for HSK 1-4

📦 What's Included

✅ Comprehensive vocabulary database for HSK levels 1-4
✅ Responsive UI built with React and Tailwind CSS
✅ Flashcard interface with multiple learning modes
✅ Favorites and session history tracking
✅ Spaced Repetition System (SRS) foundations
✅ PWA manifest and service worker setup
✅ Global SEO metadata and social sharing support

🚀 Getting Started

Installation & Development

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm build

# Validate vocabulary data
npm run validate:data

Features to Explore

Search - Try searching for vocabulary by Hanzi, Pinyin, or English
Flashcards - Visit the flashcard page and use keyboard arrows to navigate
Favorites - Star your favorite words to build a custom study list
HSK Levels - Filter by specific HSK levels to focus your learning

🐛 Known Limitations & Future Work

Current Scope

Supports HSK levels 1-4 only (levels 5-6 coming in future releases)
Vocabulary dataset includes commonly taught words for each HSK level
Data validation script available via npm run validate:data

Roadmap

[ ] HSK levels 5-6 support
[ ] User accounts and cloud sync
[ ] Spaced Repetition System (SRS) refinements
[ ] Audio pronunciation for all vocabulary
[ ] Dark mode theme
[ ] Offline mode with full vocabulary access
[ ] Community contributions for vocabulary examples

📝 Commit Summary

Features

a0e852a - Beta badge and release version bump
4f66798 - Updated global metadata
bba58fd - Added metadata, sitemap, robots, and social share images
e5bec02 - Added loading skeletons and sanitize search input
2354c79 - Added focus-level selector for HSK 1–4 on home
abdd0dd - Mobile-first redesign with bottom nav and refreshed cards
f908c42 - Redesigned footer with brand, explore links, and social profiles
54db441 - Added study mode, favorites, and PWA foundations

Fixes & Improvements

4b89160 - Resolved Turbopack build errors
36e6e98 - Fixed TypeScript compilation errors
9c38989 - Fixed favorites event dispatch
39906e7 - Improved flashcard key handling and a11y
4d57a54 - Sanitized malformed meanings
6b0571f - Fixed route params in HSK level page
57f8935 - Switched PostCSS config for Tailwind compatibility

📞 Feedback & Support

This is a beta release, and we'd love to hear your feedback!

Issues: Found a bug? Report it on GitHub Issues
Feature Requests: Have an idea? Submit it as a GitHub Discussion
Contributions: Want to help? Pull requests are welcome!

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*

HanFlash v1.0.0-beta Release Notes

🎉 Welcome to HanFlash v1.0.0-beta!

This is the first public beta release of HanFlash, a lightweight Chinese vocabulary learning web app for HSK levels 1-4.

✨ Major Features

Core Learning Experience

🔍 Instant Vocabulary Search - Search by Hanzi, Pinyin, or English meaning across HSK levels 1-4
📚 HSK Level Filtering - Browse vocabulary organized by difficulty level
🧠 Flashcard Mode - Hanzi-first recall with flip-to-reveal for pinyin, meanings, and usage examples
👁️ Hide/Reveal Controls - Toggle visibility of pinyin, meanings, and translations
⭐ Favorites System - Save and manage your favorite vocabulary items for quick review
📖 Study Mode - Dedicated interface for focused vocabulary practice

User Experience

📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile browsers
⌨️ Keyboard Navigation - Use arrow keys (←/→) to navigate through flashcards
🎯 Mobile-First UI - Bottom navigation bar and intuitive card-based design
🔄 Session Preferences - User settings persisted using localStorage
⚡ Fast Performance - Built with Next.js for optimal speed and user experience

PWA & Accessibility

🌐 Progressive Web App - Installable on mobile and desktop devices
📍 Service Worker - Offline-ready foundations for future offline support
♿ Accessibility Improvements - Focus management and keyboard controls throughout the app
📊 SEO Optimized - Comprehensive metadata, sitemap, robots.txt, and social share images (OpenGraph & Twitter)
🎨 Loading States - Skeleton screens for better perceived performance

🔧 Technical Highlights

Recent Updates

✅ Resolved TypeScript compilation errors for production builds
✅ Fixed Turbopack build errors with route config and sitemap typing
✅ Added loading skeletons and sanitized search input
✅ Improved flashcard key handling and accessibility toggles
✅ Enhanced touch event handling for mobile devices
✅ Fixed favorites event dispatch to prevent render-phase updates
✅ Added comprehensive metadata and SEO improvements
✅ Implemented HSK level selector on home page

Architecture

Monolithic Design - Frontend UI, application logic, and data access in a single Next.js application
TypeScript - Full type safety across the codebase
Tailwind CSS - Utility-first styling for responsive design
JSON-Based Data - Lightweight vocabulary database for HSK 1-4

📦 What's Included

✅ Comprehensive vocabulary database for HSK levels 1-4
✅ Responsive UI built with React and Tailwind CSS
✅ Flashcard interface with multiple learning modes
✅ Favorites and session history tracking
✅ Spaced Repetition System (SRS) foundations
✅ PWA manifest and service worker setup
✅ Global SEO metadata and social sharing support

🚀 Getting Started

Installation & Development

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm build

# Validate vocabulary data
npm run validate:data

Features to Explore

Search - Try searching for vocabulary by Hanzi, Pinyin, or English
Flashcards - Visit the flashcard page and use keyboard arrows to navigate
Favorites - Star your favorite words to build a custom study list
HSK Levels - Filter by specific HSK levels to focus your learning

🐛 Known Limitations & Future Work

Current Scope

Supports HSK levels 1-4 only (levels 5-6 coming in future releases)
Vocabulary dataset includes commonly taught words for each HSK level
Data validation script available via npm run validate:data

Roadmap

[ ] HSK levels 5-6 support
[ ] User accounts and cloud sync
[ ] Spaced Repetition System (SRS) refinements
[ ] Audio pronunciation for all vocabulary
[ ] Dark mode theme
[ ] Offline mode with full vocabulary access
[ ] Community contributions for vocabulary examples

📝 Commit Summary

Features

a0e852a - Beta badge and release version bump
4f66798 - Updated global metadata
bba58fd - Added metadata, sitemap, robots, and social share images
e5bec02 - Added loading skeletons and sanitize search input
2354c79 - Added focus-level selector for HSK 1–4 on home
abdd0dd - Mobile-first redesign with bottom nav and refreshed cards
f908c42 - Redesigned footer with brand, explore links, and social profiles
54db441 - Added study mode, favorites, and PWA foundations

Fixes & Improvements

4b89160 - Resolved Turbopack build errors
36e6e98 - Fixed TypeScript compilation errors
9c38989 - Fixed favorites event dispatch
39906e7 - Improved flashcard key handling and a11y
4d57a54 - Sanitized malformed meanings
6b0571f - Fixed route params in HSK level page
57f8935 - Switched PostCSS config for Tailwind compatibility

📞 Feedback & Support

This is a beta release, and we'd love to hear your feedback!

Issues: Found a bug? Report it on GitHub Issues
Feature Requests: Have an idea? Submit it as a GitHub Discussion
Contributions: Want to help? Pull requests are welcome!

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Learning! 🎓

*HanFlash - Learn Chinese vocabulary with focus and efficiency.*