pub.dev explorer

An app to explore and bookmark packages hosted on pub.dev.

Web App

About this app

This is a sample app showcasing the following packages.

The app shows an example of how those packages are combined. The author himself, however, is still examining and considering how they are made good use of to make the app more maintainable and easier to evolve, so the current app design is not necessarily the best.

• pottery
  • A utility widget for pot.
  • Pot is an easy and safe DI solution. It is somewhat similar to providers of pkg:riverpod in that the instance is assigned to a global variable and can be accessed from anywhere, but different in that Pot is just a service locator with only a few handy features and no complexity.
  • Pottery limits the lifetime of Pots in the widget tree, making it possible to use Pots in a similar manner to using MultiProvider of pkg:provider.
• grab
  • A package to control rebuilds of a widget based on updates of a Listenable such as ChangeNotifier and ValueNotifier.
  • Usage is similar to watch() and select() of pkg:provider, but Grab does not depend on the widget tree.
  • Take it as an extension method version of ValueListenableBuilder with filtering.
• async_phase_notifier
  • A variant of ValueNotifier similar to AsyncNotifier of pkg:riverpod.
  • AsyncPhase has one more phase "initial", which AsyncValue of Riverpod does not have.
  • AsyncPhaseNotifier provides a way to listen to errors, and there is also AsyncErrorListener that is a widget with an error handler, convenient for imperatively showing a message (e.g. showing a SnackBar) or for logging.
• custom_text
  • A highly customisable text widget that decorates substrings and enables tap / long-press / hover actions flexibly based on regular expression patterns.
  • Such decorations and actions are also available in text editing with CustomTextEditingController, although the controller is not used in this app.

How to run

Just run flutter run in the app/ directory, with additional options if necessary.

Code generation

The drift package used in this app requires code generation. If you change the classes from which code is generated, run the command below in the core/ directory to regenerate the code.

$ dart run build_runner build -d

This project already contains generated code in core/lib/src/generated/, so if you haven't changed anything, the above command is unnecessary.

Mock data for the web

The pub.dev API is not available on the web unfortunately, so mock data preset in the app is used instead. The data contains the packages that were top 100 at some point in the past.

Mock data on other platforms

To use the mock data on platforms besides the web, set the USE_MOCK environment variable to true as follows:

flutter run --dart-define=USE_MOCK=true