Search packages, repositories and app categories

Package detailsv1.0.5

shelf_proxy

A shelf handler for proxying HTTP requests to another server.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
10M
Likes
94
Pub points
160

Install package

flutter pub add shelf_proxy

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

Shelf Proxy is a Dart package that provides a Shelf handler for forwarding HTTP requests to another server. It enables developers to create proxy servers easily within Flutter or Dart applications, allowing request interception and forwarding with minimal configuration. Ideal for backend integration, API gateway patterns, or testing environments, it supports all major platforms including mobile, web, and desktop. The package integrates seamlessly with the Shelf ecosystem, offering flexibility in handling incoming requests and routing them to external services.

Use cases

  • API gateway implementation
  • Testing and development proxies
  • Backend service integration
  • Request logging and monitoring
  • Cross-origin request forwarding

Key features

  • Simple integration with Shelf
  • Supports all Dart platforms
  • Configurable target URLs
  • Transparent request/response forwarding
  • Extensible middleware compatibility

Suitable for

  • Backend developers using Shelf
  • Full-stack Flutter apps needing proxy logic
  • Dev/test environments requiring request routing
  • Microservices communication setups
  • API mocking and debugging

Considerations

  • Requires proper error handling for downstream failures
  • May introduce latency depending on target server
  • Needs secure configuration for production use
  • Limited built-in authentication mechanisms
  • CORS policies must be managed externally

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Build Status

About Shelf

Shelf makes it easy to create and compose web servers and parts of web servers. How?

  • Expose a small set of simple types.
  • Map server logic into a simple function: a single argument for the request, the response is the return value.
  • Trivially mix and match synchronous and asynchronous processing.
  • Flexibility to return a simple string or a byte stream with the same model.

It was inspired by Connect for NodeJS and Rack for Ruby.

See the package:shelf readme for more information.

Packages

Package Description Issues Version
shelf A model for web server middleware that encourages composition and easy reuse. issues pub package
shelf_packages_handler A shelf handler for serving a packages/ directory. issues pub package
shelf_proxy A shelf handler for proxying HTTP requests to another server. issues pub package
shelf_router A convenient request router for the shelf web-framework, with support for URL-parameters, nested routers and routers generated from source annotations. issues pub package
shelf_router_generator A package:build-compatible builder for generating request routers for the shelf web-framework based on source annotations. issues pub package
shelf_static Static file server support for the shelf package and ecosystem. issues pub package
shelf_test_handler A Shelf handler that makes it easy to test HTTP interactions. issues pub package
shelf_web_socket A shelf handler that wires up a listener for every connection. issues pub package
_shelf_compliance HTTP/1.1 compliance and hardening tests. issues (not published)

Publishing automation

For information about our publishing automation and release process, see https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.

Categories

Dependencies

Dependency list 3 items

Source repository

Projects using this package