SakuYado LogoSakuYado
✨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 checkRatingΒ² Γ· Price
  • Strict Budget: Ideal for budget-conscious travelers focusing on absolute price for a given ratingRating Γ· Price
  • Quality First: Best for premium hotel comparisons where quality justifies larger price increasesRating Γ· 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