shelf_appengine 0.2.3

  • Installing
  • Versions
  • 30

A set helpers to make it easy to use Shelf on App Engine.

Running the Example

Example code for this package does not follow Dart conventions. The package is structured so it can be run directly using gcloud.

Using pub build

The easiest way to run the sample is to run pub build before you execute gcloud preview app run app.yaml. If you change the content of the web Directory, you will have to rerun pub build.

Using pub serve

If you'd like to use pub serve during development, follow the instructions here. Note: you will still need to run pub build before you deploy.


  • Added port argument to serve function. Requires appengine >= 0.3.1.


  • Better handling of default document serving.


  • Support latest release of appengine package.


  • Made DirectoryIndexServeMode an enum.

  • Support the latest version of shelf package.

  • Require Dart 1.9 or greater.


  • Fixing an issue causing the DirectoryIndexServeMode.SERVE mode to have no effect.


  • Made assetHandler a function.

  • Added the directoryIndexServeMode named parameter to the assetHandler method to enable auto-serving or redirecting to index.html files. Allow changing the default index files name to serve with indexFileName.


  • Formatted the code.

  • Updated example code to run on the latest configuration.


  • Added logging for asset errors.


  • First public release.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  shelf_appengine: "^0.2.3"

2. Install it

You can install packages from the command line:

with pub:

$ pub get

with Flutter:

$ flutter packages get

Alternatively, your editor might support pub get or flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

      import 'package:shelf_appengine/shelf_appengine.dart';
Version Uploaded Documentation Archive
0.2.3 Aug 7, 2015 Go to the documentation of shelf_appengine 0.2.3 Download shelf_appengine 0.2.3 archive
0.2.2+1 Jun 18, 2015 Go to the documentation of shelf_appengine 0.2.2+1 Download shelf_appengine 0.2.2+1 archive
0.2.2 Jun 1, 2015 Go to the documentation of shelf_appengine 0.2.2 Download shelf_appengine 0.2.2 archive
0.2.1 Jun 1, 2015 Go to the documentation of shelf_appengine 0.2.1 Download shelf_appengine 0.2.1 archive
0.2.0+1 Feb 26, 2015 Go to the documentation of shelf_appengine 0.2.0+1 Download shelf_appengine 0.2.0+1 archive
0.2.0 Feb 25, 2015 Go to the documentation of shelf_appengine 0.2.0 Download shelf_appengine 0.2.0 archive
0.1.1+2 Nov 10, 2014 Go to the documentation of shelf_appengine 0.1.1+2 Download shelf_appengine 0.1.1+2 archive
0.1.1+1 Nov 6, 2014 Go to the documentation of shelf_appengine 0.1.1+1 Download shelf_appengine 0.1.1+1 archive
0.1.1 Nov 6, 2014 Go to the documentation of shelf_appengine 0.1.1 Download shelf_appengine 0.1.1 archive
0.3.0-alpha Mar 19, 2017 Go to the documentation of shelf_appengine 0.3.0-alpha Download shelf_appengine 0.3.0-alpha archive


We analyzed this package on Jun 12, 2018, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.0.0-dev.60.0
  • pana: 0.11.3


Describes how popular the package is relative to other packages. [more]
0 / 100
Code health derived from static analysis. [more]
100 / 100
Reflects how tidy and up-to-date the package is. [more]
0 / 100
Overall score:
Weighted score of the above. [more]
Learn more about scoring.


Detected platforms: Flutter, other

Primary library: package:shelf_appengine/shelf_appengine.dart with components: io.


  • Package is too old.

    The package was released more than two years ago.

  • The description is too short.

    Add more detail about the package, what it does and what is its target use case. Try to write at least 60 characters.

  • Package is pre-v1 release.

    While there is nothing inherently wrong with versions of 0.*.*, it usually means that the author is still experimenting with the general direction API.

  • Maintain an example.

    Create a short demo in the example/ directory to show how to use this package. Common file name patterns include: main.dart, example.dart or you could also use shelf_appengine.dart.


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.9.0 <2.0.0
appengine ^0.3.1 0.3.3+1 0.4.4
mime ^0.9.0 0.9.6+1
shelf ^0.6.0 0.6.8 0.7.3+1
stack_trace ^1.0.0 1.9.2
Transitive dependencies
_discoveryapis_commons 0.1.6
async 1.13.3 2.0.7
charcode 1.1.1
collection 1.14.10
convert 2.0.1
crypto 2.0.3
fixnum 0.10.7
gcloud 0.3.0 0.5.0
googleapis 0.31.0 0.51.0
googleapis_auth 0.2.5
googleapis_beta 0.30.1 0.46.0
http_parser 3.1.2
http_server 0.9.7
logging 0.11.3+1
memcache 0.2.2 0.3.0
path 1.6.0
protobuf 0.5.5 0.9.0
source_span 1.4.0
stream_channel 1.6.7+1
string_scanner 1.0.2
typed_data 1.1.5
Dev dependencies
http ^0.11.2 0.11.3+16
scheduled_test ^0.12.0
test ^0.12.0