Merge pull request #5 from material-components/reply_readme_theming

Reply readme theming

Author: hunterstich

Reply/README.md

@@ -1,14 +1,51 @@
 # Reply
-
 <img src="screenshots/collage_header.png" alt="Reply collage"/>
 
-### Introduction
+## Introduction
 Reply is an email app that uses Material Design components and Material Theming to create an on-brand communication experience. 
 This project is the Android implementation of [Reply](https://material.io/design/material-studies/reply.html), a Material Study meant to showcase componentry and Theming using the Material Components for Android library. 
 
-### Screenshots
-
+## Screenshots
 <img src="screenshots/1_home_screen.png" height="400" alt="Home screen"/> <img src="screenshots/2_navigation_drawer.png" height="400" alt="Navigation drawer open"/> <img src="screenshots/3_account_sandwich.png" height="400" alt="Account picker sandwich open"/> 
 
 <img src="screenshots/4_star_email_action.png" height="400" alt="Star an email action"/> <img src="screenshots/5_email_details.png" height="400" alt="Email details screen"/> <img src="screenshots/6_email_compose.png" height="400" alt="Compose email screen"/> 
 
+## Material Theming
+Reply uses Material Theming to create a content-forward experience through the customization of [color](https://material.io/develop/android/theming/color/), [typography](https://material.io/develop/android/theming/typography/) and [shape](https://material.io/develop/android/theming/shape/).
+
+### Color
+<img src="screenshots/color_header.png" width="700" alt="Reply color theming"/> 
+
+Reply uses a simple, subtle color scheme to save emphasis for email content.  Reply’s color palette is defined in [color.xml](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/color.xml) and applied globally via the app’s [light](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/themes.xml#L23-L37) and [dark](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values-night/themes.xml#L22-L36) themes.
+
+### Typography
+<img src="screenshots/typography_header.png" width="700" alt="Reply typography theming"/> 
+
+Reply uses [Work Sans](https://fonts.google.com/specimen/Work+Sans)
+ as its typeface. All items in the type scale provide the typographic variety necessary for Reply’s content. See [type.xml](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/type.xml) which defines `TextAppearance`s which are then [set in the theme](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/themes.xml#L48-L59) and referred to using `?attr/textAppearance[...]` throughout.
+
+### Shape
+<img src="screenshots/shape_header.png" width="700" alt="Reply shape theming"/> 
+
+Reply defines small, medium and large shape categories for different sized components. See [shape.xml](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/shape.xml) which defines the `ShapeAppearance`s, which are then [set in the theme](https://github.com/material-components/material-components-android-examples/blob/develop/Reply/app/src/main/res/values/themes.xml#L43-L45) and picked up by all components or referred to directly.
+
+## License
+
+```
+Copyright 2019 Google, Inc.
+
+Licensed to the Apache Software Foundation (ASF) under one or more contributor
+license agreements. See the NOTICE file distributed with this work for
+additional information regarding copyright ownership. The ASF licenses this
+file to you under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License. You may obtain a copy of
+the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations under
+the License.
+```