Add Owl sample.

Author: nickbutcher

Owl/README.md

@@ -0,0 +1,49 @@
+# Owl
+
+<img src="screenshots/collage_header.png" alt="Owl collage"/>
+
+## Introduction
+Owl is an educational app that uses Material Design components and [Material Theming](https://material.io/design/material-theming) to create an energetic, motivational brand experience.
+This project is an Android implementation of [Owl](https://material.io/design/material-studies/owl.html), a Material study meant to showcase componentry and theming using the [Material Components for Android library](https://github.com/material-components/material-components-android).
+
+## Screenshots
+<img src="screenshots/owl_demo.gif" alt="Owl sample demo"/>
+
+## Material Theming
+Owl employs material theming to reflect the energy and excitement of learning a new skill, using a bold aesthetic and unfilled shapes that invite the user to populate them with new content and courses. The app customizes [color](https://material.io/develop/android/theming/color/), [shape](https://material.io/develop/android/theming/shape/) and [typography](https://material.io/develop/android/theming/typography/) to achieve this.
+
+### Color
+<img src="screenshots/color_header.png" alt="Owl color theming"/>
+
+Owl has three primary colors. Each color is used to create a distinct visual theme for each section. See [colors.xml](https://github.com/material-components/material-components-android-examples/blob/develop/owl/app/src/main/res/values/color.xml) and how they are used in [light](https://github.com/material-components/material-components-android-examples/blob/develop/owl/app/src/main/res/values/themes.xml#L58-L86) and [dark](https://github.com/material-components/material-components-android-examples/blob/develop/owl/app/src/main/res/values-night/themes.xml) themes.
+
+### Shape
+<img src="screenshots/shape_header.png" alt="Owl shape theming"/>
+
+Owl 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/owl/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/owl/app/src/main/res/values/themes.xml#L20-L23) and picked up by all components or refferred to directly.
+
+### Typography
+<img src="screenshots/type_header.png" alt="Owl typography theming"/>
+
+Owl’s type scale provides the typographic variety necessary for the app content. All items in the type scale use [Rubik](https://fonts.google.com/specimen/Rubik) as the typeface, and make use of the variety of weights available by using Rubik Regular, Medium, and Bold. See [type.xml](https://github.com/material-components/material-components-android-examples/blob/develop/owl/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/owl/app/src/main/res/values/themes.xml#L25-L38) and referred to using `?attr/textAppearance[...]` throughout.
+
+## 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.
+```

Owl/app/build.gradle

@@ -0,0 +1,63 @@
+/*
+ *   Copyright (c) 2019 Google Inc.
+ *
+ *   Licensed 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.
+ */
+
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-kapt'
+apply plugin: 'androidx.navigation.safeargs.kotlin'
+
+android {
+    compileSdkVersion 29
+    defaultConfig {
+        applicationId 'com.materialstudies.owl'
+        minSdkVersion 23
+        targetSdkVersion 29
+        versionCode 1
+        versionName '1.0'
+        vectorDrawables.useSupportLibrary = true
+    }
+    dataBinding {
+        enabled true
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+    kotlinOptions {
+        jvmTarget = "1.8"
+    }
+}
+
+dependencies {
+    implementation 'androidx.appcompat:appcompat:1.1.0'
+    implementation 'androidx.fragment:fragment:1.2.0-beta02'
+    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
+    implementation 'androidx.core:core-ktx:1.1.0'
+    implementation 'com.google.android.material:material:1.1.0-beta01'
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+
+    implementation "androidx.navigation:navigation-runtime-ktx:$nav_version"
+    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
+    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
+    implementation 'androidx.dynamicanimation:dynamicanimation:1.0.0'
+
+    implementation 'com.github.bumptech.glide:glide:4.9.0'
+    annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+}

Owl/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

Owl/app/src/main/AndroidManifest.xml

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Copyright (c) 2019 Google Inc.
+
+  Licensed 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.
+  -->
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="com.materialstudies.owl">
+
+  <!--Load images from Unsplash-->
+  <uses-permission android:name="android.permission.INTERNET"/>
+
+  <application
+      android:allowBackup="true"
+      android:icon="@mipmap/ic_launcher"
+      android:label="@string/app_name"
+      android:name="OwlApplication"
+      android:supportsRtl="true"
+      android:theme="@style/Owl.Blue"
+      tools:ignore="GoogleAppIndexingWarning">
+
+    <activity
+        android:name=".ui.MainActivity"
+        android:theme="@style/Owl.Blue">
+      <intent-filter>
+        <action android:name="android.intent.action.MAIN"/>
+        <category android:name="android.intent.category.LAUNCHER"/>
+      </intent-filter>
+    </activity>
+
+    <!--Preload custom fonts-->
+    <meta-data
+        android:name="preloaded_fonts"
+        android:resource="@array/preloaded_fonts"/>
+    <meta-data
+        android:name="fontProviderRequests"
+        android:value="Rubik"/>
+
+  </application>
+
+</manifest>

Owl/app/src/main/java/com/materialstudies/owl/OwlApplication.kt

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2019 Google LLC
+ *
+ * Licensed 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
+ *
+ *     https://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.
+ */
+
+package com.materialstudies.owl
+
+import android.app.Application
+import android.os.Build.VERSION.SDK_INT
+import android.os.Build.VERSION_CODES.Q
+import androidx.appcompat.app.AppCompatDelegate
+
+class OwlApplication : Application() {
+
+    override fun onCreate() {
+        super.onCreate()
+        val nightMode = if (SDK_INT >= Q) {
+            AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM
+        } else {
+            AppCompatDelegate.MODE_NIGHT_AUTO_BATTERY
+        }
+        AppCompatDelegate.setDefaultNightMode(nightMode)
+    }
+
+}

Owl/app/src/main/java/com/materialstudies/owl/model/Course.kt

@@ -0,0 +1,162 @@
+/*
+ * Copyright 2019 Google LLC
+ *
+ * Licensed 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
+ *
+ *     https://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.
+ */
+
+package com.materialstudies.owl.model
+
+import androidx.recyclerview.widget.DiffUtil
+
+typealias CourseId = Long
+
+data class Course(
+    val id: CourseId,
+    val name: String,
+    val subject: String,
+    val thumbUrl: String,
+    val thumbContentDesc: String,
+    val description: String = "",
+    val steps: Int,
+    val step: Int,
+    val instructor: String = "https://i.pravatar.cc/112?$id"
+)
+
+object CourseDiff : DiffUtil.ItemCallback<Course>() {
+    override fun areItemsTheSame(oldItem: Course, newItem: Course) = oldItem.id == newItem.id
+    override fun areContentsTheSame(oldItem: Course, newItem: Course) = oldItem == newItem
+}
+
+object CourseRepo {
+    fun getCourse(id: CourseId) = courses.find { it.id == id } ?: courses.last()
+}
+
+val courses = listOf(
+    Course(
+        id = 0,
+        name = "Basic Blocks and Woodturning",
+        subject = "Arts & Crafts",
+        thumbUrl = "https://source.unsplash.com/oJ7SV6vQfBA",
+        thumbContentDesc = "",
+        steps = 7,
+        step = 1
+    ),
+    Course(
+        id = 1,
+        name = "An Introduction To Oil Painting On Canvas",
+        subject = "Painting",
+        thumbUrl = "https://source.unsplash.com/W9_sznrBmoA",
+        thumbContentDesc = "",
+        steps = 12,
+        step = 1
+    ),
+    Course(
+        id = 2,
+        name = "Understanding the Composition of Modern Cities",
+        subject = "Architecture",
+        thumbUrl = "https://source.unsplash.com/s4I1xpX_ny8",
+        thumbContentDesc = "",
+        steps = 18,
+        step = 1
+    ),
+    Course(
+        id = 3,
+        name = "Learning The Basics of Brand Identity",
+        subject = "Design",
+        thumbUrl = "https://source.unsplash.com/G9_Euqxpu4k",
+        thumbContentDesc = "",
+        steps = 22,
+        step = 1
+    ),
+    Course(
+        id = 4,
+        name = "Wooden Materials and Sculpting Machinery",
+        subject = "Arts & Crafts",
+        thumbUrl = "https://source.unsplash.com/o54RjF-C7xo",
+        thumbContentDesc = "",
+        steps = 19,
+        step = 1
+    ),
+    Course(
+        id = 5,
+        name = "Advanced Potter's Wheel",
+        subject = "Arts & Crafts",
+        thumbUrl = "https://source.unsplash.com/-LHvba-FgAo",
+        thumbContentDesc = "",
+        steps = 14,
+        step = 1
+    ),
+    Course(
+        id = 6,
+        name = "Advanced Abstract Shapes & 3D Printing",
+        subject = "Arts & Crafts",
+        thumbUrl = "https://source.unsplash.com/HQkz_lWT_lY",
+        thumbContentDesc = "",
+        steps = 17,
+        step = 1
+    ),
+    Course(
+        id = 7,
+        name = "Beginning Portraiture",
+        subject = "Photography",
+        thumbUrl = "https://source.unsplash.com/LE0Hp8l9gvs",
+        thumbContentDesc = "",
+        steps = 22,
+        step = 1
+    ),
+    Course(
+        id = 8,
+        name = "Intermediate Knife Skills",
+        subject = "Culinary",
+        thumbUrl = "https://source.unsplash.com/f1xj_KeZ5RM",
+        thumbContentDesc = "",
+        steps = 14,
+        step = 1
+    ),
+    Course(
+        id = 9,
+        name = "Pattern Making for Beginners",
+        subject = "Fashion",
+        thumbUrl = "https://source.unsplash.com/hew8-OoUriU",
+        thumbContentDesc = "",
+        steps = 7,
+        step = 1
+    ),
+    Course(
+        id = 10,
+        name = "Location Lighting for Beginners",
+        subject = "Photography",
+        thumbUrl = "https://source.unsplash.com/pPxJTtxfV1A",
+        thumbContentDesc = "",
+        steps = 6,
+        step = 1
+    ),
+    Course(
+        id = 11,
+        name = "Cinematography & Lighting",
+        subject = "Film",
+        thumbUrl = "https://source.unsplash.com/oIf4VCDztZY",
+        thumbContentDesc = "",
+        steps = 4,
+        step = 1
+    ),
+    Course(
+        id = 12,
+        name = "Monuments, Buildings & Other Structures",
+        subject = "Photography",
+        thumbUrl = "https://source.unsplash.com/KxCJXXGsv9I",
+        thumbContentDesc = "",
+        steps = 4,
+        step = 1
+    )
+)