Skip to main content

Building For Web

Use the Web target for the fastest Hosanna development loop and for browser-delivered releases. Web is also the best place to validate shared AppConfig, fragments, focus, input adapters, networking, and visual layout before moving to device targets.

Prerequisites​

  • Node.js and project dependencies installed with npm install.
  • Access to the licensed Hosanna framework sources and tooling for the project.
  • Browser DevTools, Hosanna DevTools, and MCP debugger access for deeper runtime inspection.

Run Locally​

Use the configured Web launch target or project script. In most Hosanna projects, the Web launch target starts Vite and watches generated structs automatically.

npm run dev

If your project separates generation from the dev server, start the generator first:

npm run generate-watch

Production Build​

Build the Web target with the project release script:

npm run build

Validate the generated assets, AppConfig loading, routes, fonts, images, environment variables, and deployment base path before release.

Debugging​

  • Use browser DevTools for rendering, network, performance, and console output.
  • Use Hosanna DevTools and the MCP debugger for app state, focus, input, logs, screenshots, and runtime tree inspection.
  • Validate keyboard, pointer, touch, remote emulation, DPI, and design-resolution behavior.

See Web and Web Expression, DPI, and Touch Input for Web-specific runtime notes.