Release Notes

Product updates and history

Track what's new in HanFlash, from the latest stable release to early beta milestones.

v2.0.0Latest

Jump to release details →

v1.0.0-betaBeta

Jump to release details →

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.