β¨User Guide
SakuYado Features πΈ
Everything you can do with SakuYado β from adding hotels to comparing value scores.
Core Functionality
π Hotel Value Calculation
- Balanced (Default): The 'Sweet Spot' - rewards higher quality significantly while keeping price in check
RatingΒ² Γ· Price - Strict Budget: Ideal for budget-conscious travelers focusing on absolute price for a given rating
Rating Γ· Price - Quality First: Best for premium hotel comparisons where quality justifies larger price increases
Rating Γ· ln(Price) - Smart Ranking: Hotels are automatically sorted by value score (highest first) across all strategies
π¨ Hotel Management
- Add Hotels: Simple form with real-time validation for name, price (positive numbers), and rating (0-10)
- Data Persistence: Hotel data and selected strategies are automatically saved to localStorage for later sessions
- Currency Memory: Automatically remembers and defaults to your last used currency for faster entry
- Currency Consistency: Requires comparing hotels using the same metric currency for accurate mathematical value scoring
π Comparison Features
- Side-by-Side Comparison: Interactive data table (desktop) and card list (mobile) for easy comparisons
- Visual Ranking: Clear visual hierarchy with gold crown (π) and pink highlights for the best value options
- Detailed Statistics: Dynamic summary showing hotel count, top score, lowest price, and highest rating
- Comprehensive Testing: Thoroughly verified through Vitest unit tests and Cypress end-to-end journey tests
User Experience
π± Responsive Design
- βMobile-First layout from 375px upwards
- βFull desktop experience optimized for 1280px+
- βTouch-friendly interactive elements
- βAccessible with ARIA labels and keyboard navigation
π¨ Interface Elements
- βMinimalist sakura (cherry blossom) aesthetic
- βFluid typography and layout with modern CSS clamp
- βReal-time input validation and friendly error feedback