Overview
A lightweight HTTP proxy for the webdev serve command, designed to support Flutter applications using HTML5 routing. It intercepts 404 errors and rewrites them to serve the root index.html file, enabling seamless client-side routing without server configuration. Ideal for single-page apps that rely on history API navigation. The proxy runs alongside webdev and requires no changes to existing code or build processes.
Use cases
- Supporting HTML5 routing in Flutter web apps
- Handling client-side routing with 404 fallbacks
- Simplifying development for SPAs
- Enabling deep linking in web apps
- Avoiding server-side route configuration
Key features
- Rewrites 404s to index.html
- Integrates with webdev serve
- Minimal setup required
- Cross-platform (macOS, Windows, Linux)
- No code changes needed
Suitable for
- Flutter developers using HTML5 routing
- SPA developers on the web
- Local development environments
- Apps with deep linking needs
- Teams avoiding complex server setups
Considerations
- Not intended for production use
- Requires webdev to be running
- Limited to serving static assets
- Does not handle dynamic routes
- Proxy must be started manually