Moving Shrine into a material_studies subdirectory (#128)

material_studies/shrine/README.md

@@ -0,0 +1,45 @@
+# Shrine
+
+A sample shopping app that uses Material Component widgets in its UI and
+[`scoped_model`](https://pub.dartlang.org/packages/scoped_model) to
+manage the state of its shopping cart.
+
+## Goals
+
+* Show how to customize Flutter's Material Component widgets to produce
+  a unique design for an app.
+* Show how to use `scoped_model` to manage an app's state and access it
+  across different routes and in different widgets.
+
+This is a modified version of the app featured in Flutter's
+[Material codelabs](https://codelabs.developers.google.com/?cat=Flutter).
+
+## The important bits
+
+### `/model/app_state_model.dart`
+
+The model object representing the state of the app. It holds the
+available products as well as what's in the shopping cart.
+
+### `/supplemental`
+
+A bunch of widgets that customize Material to produce the look and feel
+of the app.
+
+### `shopping_cart.dart`
+
+The shopping cart widgets. They access the app state model via
+`ScopedModelDescendant`, display the contents of the shopping cart, and
+allow the user to edit them.
+
+## Questions/issues
+
+If you have a general question about any of the techniques you see in
+the sample, the best places to go are:
+
+* [The FlutterDev Google Group](https://groups.google.com/forum/#!forum/flutter-dev)
+* [The Flutter Gitter channel](https://gitter.im/flutter/flutter)
+* [StackOverflow](https://stackoverflow.com/questions/tagged/flutter)
+
+If you run into an issue with the sample itself, please file an issue
+in the [main Flutter repo](https://github.com/flutter/flutter/issues).