webf-quickstart_skill

Overview

This skill walks you through getting started with WebF development: install WebF Go, create a Vite-powered React/Vue/Svelte project, and load your first app for development testing. It focuses on the minimal setup (Node.js only) and the workflow differences between development (using WebF Go) and production (building a Flutter app with WebF integration). Follow practical steps to run, test, hot-reload, and debug your web app inside WebF during development.

How this skill works

You create a standard Vite web project and run the dev server as usual. Instead of a browser, point WebF Go at the dev server URL (local or network) to render and test the app. For mobile testing expose the dev server with the --host flag and use the network URL from a device on the same WiFi. For production, build the web bundle and load it inside a Flutter app that includes the WebF Flutter package.

When to use it

• Starting a new WebF-powered native app project
• Onboarding web developers to the WebF workflow
• Testing UI and hot-reload behavior in a WebF environment
• Running quick cross-platform prototypes without Flutter SDK
• Preparing web bundle for later Flutter integration

Best practices

• Use Node.js LTS and create projects with Vite for predictable tooling
• Treat WebF Go strictly as a development/testing tool — do not distribute it
• For mobile testing run npm run dev -- --host and use the network URL
• Open Chrome DevTools via the WebF Go debug button for DOM and network inspection
• Build the web bundle (npm run build) and integrate into a Flutter app for production

Example use cases

• Quickly prototype a React UI and verify rendering in WebF Go on desktop
• Test responsive behavior on a phone by serving the dev server with --host and using the device URL
• Onboard a web developer to native app workflow without installing Flutter
• Verify Vite hot-module-replacement works inside WebF during iterative development
• Prepare a web bundle and hand it to a Flutter engineer for WebF integration