Can it fix HMR issues on real devices?

Absolutely. It checks WebSocket (ws://) reachability and ensures the client-side HMR configuration matches the dev server's actual network address.

Why won't my WebF app connect to my local dev server?

This usually happens when the server is bound to 'localhost' instead of your LAN IP or 0.0.0.0, preventing external devices on the same network from accessing the server.

Does this skill support both Vite and Webpack?

Yes, it provides specific guidance for both Vite and Webpack configurations, including the --host flag and WebSocket client settings.

What information should I provide to start troubleshooting?

Providing your target platform (iOS/Android), dev server URL, and your build tool (Vite/Webpack) allows the skill to diagnose the issue immediately.

Does it help with firewall issues?

Yes, the skill identifies when network traffic might be blocked by OS firewalls or port restrictions that prevent the mobile device from reaching your workstation.

OpenWebF Dev Server & Network Troubleshooter

Name: OpenWebF Dev Server & Network Troubleshooter
Author: archview-ai

byarchview-ai

0•

Mobile Development

Resolves network reachability and HMR issues for WebF applications running on real devices and local development servers.

This skill streamlines the process of debugging connectivity between your local development server—such as Vite or Webpack—and WebF-powered applications on iOS, Android, or desktop. It identifies common pitfalls like localhost vs. LAN IP binding, 0.0.0.0 configuration requirements, firewall blocks, and WebSocket/HMR failures, ensuring your real-time code updates sync perfectly across your physical test devices.

Key Features

010 GitHub stars

02Firewall and port access verification for cross-device development

03Automated troubleshooting for Vite and Webpack dev server bindings

04Integration guidance for WebF-specific networking requirements

05Diagnostic support for Hot Module Replacement (HMR) and WebSocket failures

06Resolution of LAN IP vs. localhost connectivity issues on mobile hardware

Use Cases

01Configuring Vite or Webpack to allow HMR updates over a local area network

02Debugging why a device can load initial HTML but fails to fetch assets or trigger HMR

03Fixing 'Connection Refused' errors when testing WebF apps on physical mobile devices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add archview-ai/webf-plugin openwebf-app-devserver-network

For use in Claude.ai and ChatGPT

Download Skill