safari-ios-compatibility

Diagnose and fix Safari iOS compatibility issues in Vue/Vite apps.

Updated Aug 30, 2025
One-click install
npx skills add https://github.com/lbolanos/emaus --skill safari-ios-compatibility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: safari-ios-compatibility
Source: https://github.com/lbolanos/emaus/tree/main/.ruler/skills/safari-ios-compatibility
Command: npx skills add https://github.com/lbolanos/emaus --skill safari-ios-compatibility

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Diagnoses and fixes Safari iOS-specific issues in Vue/Vite SPAs, preventing blank pages and evaluation errors.

Core Features & Use Cases

  • Problem Resolution: Identifies causes such as deep module evaluation, large chunks, and i18n parsing errors specific to Safari iOS.
  • Development Guidance: Provides fixes like lazy-loading components, chunk splitting, and escaping characters in translation files.
  • Use Case: When users report blank pages on iPhone, use this guidance to troubleshoot and resolve Vue/Vite deployment issues for Safari iOS.

Quick Start

Use this skill to diagnose Safari iOS compatibility issues in your Vue/Vite project and implement recommended fixes.

Frequently Asked Questions about safari-ios-compatibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Vue Vite app show a white screen on Safari iOS?

White screens on Safari iOS in Vue Vite apps are typically caused by deep module evaluation stack overflows, large chunk crashes, or i18n translation parsing errors. Identifying these specific Safari iOS limitations helps pinpoint the exact trigger to restore application stability.

How do I fix module evaluation stack overflow errors in Safari iOS?

Fix Safari iOS module evaluation stack overflows by implementing lazy-loading components and applying proper code splitting. Refactoring multi-root component structures reduces deep evaluation chains, preventing crashes and improving Vue Vite app performance on Apple devices.

What is the best way to prevent large chunk crashes on Safari iOS?

Preventing large chunk crashes on Safari iOS requires configuring chunk splitting in your Vue Vite build process. Breaking down large JavaScript bundles into smaller lazy-loaded chunks ensures Safari iOS can evaluate modules without hitting memory limits.

How do I resolve i18n translation parsing errors on Safari iOS?

Resolve Safari iOS i18n translation parsing errors by properly escaping special characters in your translation files. Correctly formatting these strings prevents Safari's parser from failing, ensuring Vue Vite text renders correctly on Apple mobile devices.

Do I need polyfills for older Safari iOS versions when using Vue Vite?

Yes, preparing older Safari polyfills is necessary when supporting legacy Apple devices with Vue Vite applications. Adding polyfills ensures modern JavaScript features missing in older Safari iOS versions are handled correctly, maintaining compatibility and preventing blank pages.