{"id":13427729,"url":"https://github.com/nickbutcher/plaid","last_synced_at":"2025-05-13T21:11:17.415Z","repository":{"id":40344143,"uuid":"45261969","full_name":"nickbutcher/plaid","owner":"nickbutcher","description":"An Android app which provides design news \u0026 inspiration as well as being an example of implementing material design.","archived":false,"fork":false,"pushed_at":"2024-01-04T20:49:31.000Z","size":33949,"stargazers_count":16255,"open_issues_count":102,"forks_count":3142,"subscribers_count":617,"default_branch":"main","last_synced_at":"2025-05-10T08:01:59.782Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nickbutcher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-10-30T16:10:56.000Z","updated_at":"2025-05-09T11:58:08.000Z","dependencies_parsed_at":"2024-01-10T22:10:32.201Z","dependency_job_id":"aec91f75-41a7-4e44-9b33-3e230f43b970","html_url":"https://github.com/nickbutcher/plaid","commit_stats":null,"previous_names":["android/plaid"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickbutcher%2Fplaid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickbutcher%2Fplaid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickbutcher%2Fplaid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickbutcher%2Fplaid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nickbutcher","download_url":"https://codeload.github.com/nickbutcher/plaid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254029003,"owners_count":22002283,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T01:00:39.443Z","updated_at":"2025-05-13T21:11:12.401Z","avatar_url":"https://github.com/nickbutcher.png","language":"Kotlin","funding_links":[],"categories":["Libraries",":shamrock:  **Categories**","Android","Kotlin","Java","Android Apps (Search Results)","Samples","开源项目学习","App / Demo","Plaid"],"sub_categories":[":art: Misc"],"readme":"# \\[ 🚧 Work in progress 👷‍♀️⛏👷🔧️👷🔧 🚧 \\] Plaid 2.0 \n\nRewriting Plaid using [Android Architecture Components](https://developer.android.com/topic/libraries/architecture/), in Kotlin. \n\n👀 \"[Up for grabs](https://github.com/nickbutcher/plaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Up+for+grabs+%F0%9F%A4%9A%22)\" issues – We're happy to [get your contributions](https://github.com/nickbutcher/plaid/blob/master/CONTRIBUTING.md#contributing-a-patch) on those!\n\n👍 Comments and new issues created are welcomed.\n\n🛑 We're currently not accepting external PRs that touch on the app's architecture.\n\n[![CircleCI](https://circleci.com/gh/android/plaid/tree/master.svg?style=shield)](https://circleci.com/gh/android/plaid/tree/master)\n\n### Background\n\nPlaid was written with one big goal: showcase material design in Android in a real application. While Plaid successfully achieved its goal, from an architecture point of view, it lacks all features that would make it a modular, scalable, testable and maintainable app: with UI logic in Android classes, no tests and only one module. \nPlaid represents a great real world app example: it provides a fairly complex set of functionalities, it has technical debt, it has features that have to be dealt with as APIs are being removed.\nAll of these problems are encountered by many projects in the Android community and therefore, make Plaid a suitable showcase for all the advantages that architecture components bring. \n\n#### More information\n\n* Read more:\n\n\t* [Restitching Plaid - Updating Plaid to modern app standards](https://medium.com/@crafty/restitching-plaid-9ca5588d3b0a)\n\t* [A patchwork Plaid - Monolith to modularized app](https://medium.com/androiddevelopers/a-patchwork-plaid-monolith-to-modularized-app-60235d9f212e)\n\t* [Cross-stitching Plaid and AndroidX](https://medium.com/androiddevelopers/cross-stitching-plaid-and-androidx-7603a192348e)\n\t* [Dependency injection in a multi module project](https://medium.com/androiddevelopers/dependency-injection-in-a-multi-module-project-1a09511c14b7)\n\n* Video Presentations:\n\n\t* [Shaping Your App's Architecture with Kotlin and Architecture Components by Florina](https://youtu.be/Sy6ZdgqrQp0) (Florina Muntenescu at KotlinConf 2018)\n\t* [Re-stitching Plaid with Kotlin](https://youtu.be/NNWejxBORgc) (Florina Muntenescu at Android Dev Summit '18)\n\n### Goals\n* Migrate Plaid to Architecture Components. The refactoring will follow the architecture described in [Guide to App Architecture](https://developer.android.com/jetpack/docs/guide).  \n* Convert to Kotlin, while migrating to Architecture Components.\n* Modularize the app using [dynamic feature modules](https://developer.android.com/guide/app-bundle/).\n* Showcase the extensibility of the architecture by adding an extra data source, once the migration is finished.\n\n### Non-Goals\nChanges to the styles, themes, icons, animations, transitions or any other UI elements that were the initial focus of Plaid, are outside the scope of this refactoring. \n\n### Android Studio IDE setup\n\nPlaid requires Android Studio version 3.6 or higher.\n\nPlaid uses [ktlint](https://ktlint.github.io/) to enforce Kotlin coding styles.\nHere's how to configure it for use with Android Studio (instructions adapted\nfrom the ktlint [README](https://github.com/shyiko/ktlint/blob/master/README.md)):\n\n- Close Android Studio if it's open\n- Download ktlint using these [installation instructions](https://github.com/shyiko/ktlint/blob/master/README.md#installation)\n\n- Inside the project root directory run:\n\n  `./ktlint --apply-to-idea-project --android`\n\n- Remove ktlint if desired:\n\n  `rm ktlint`\n\n- Start Android Studio\n\n---\n\n# Plaid 1.0\n\n\u003cimg src=\"screenshots/plaid_demo.gif\" width=\"300\" align=\"right\" hspace=\"20\"\u003e\n\n*Design news and inspiration.*\n\nPlaid is a showcase of [material design](https://www.google.com/design/spec/) that we hope you will\nkeep installed. It pulls in news \u0026 inspiration from [Designer News](https://www.designernews.co/),\n[Dribbble](https://dribbble.com/) \u0026 [Product Hunt](https://www.producthunt.com/). It demonstrates\nthe use of\n[material principles](https://www.google.com/design/spec/material-design/introduction.html#introduction-principles)\nto create tactile, bold, understandable UIs.\n\n**[Install on Google Play (Beta Testing)](https://play.google.com/apps/testing/io.plaidapp)**\n\n\n### Screenshots\n\n\n\u003cimg src=\"screenshots/home_grid_framed.png\" width=\"25%\" /\u003e\n\u003cimg src=\"screenshots/post_story_framed.png\" width=\"25%\" /\u003e\n\u003cimg src=\"screenshots/dn_story_framed.png\" width=\"25%\" /\u003e\n\u003cimg src=\"screenshots/dribbble_shot_framed.png\" width=\"25%\" /\u003e\n\n\n##### Non-Goals\nPlaid is a UI sample and seeks to demonstrate how to implement material design. To make this as clear as possible it explicitly does not attempt to:\n* Provide opinionated **architecture/testing** advice; it utilizes vanilla Android components. For advice on this, I'd recommend [Blueprints](https://github.com/googlesamples/android-architecture).\n* Support **pre-Lollipop** devices. Doing so is entirely possible, but complicates things. For advice on doing this, see [this fork](https://github.com/hzsweers/plaid/tree/z/moarbackport).\n\n\n### License\n\n\n```\nCopyright 2015 Google LLC.\n\nLicensed to the Apache Software Foundation (ASF) under one or more contributor\nlicense agreements. See the NOTICE file distributed with this work for\nadditional information regarding copyright ownership. The ASF licenses this\nfile to you under the Apache License, Version 2.0 (the \"License\"); you may not\nuse this file except in compliance with the License. You may obtain a copy of\nthe License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\nWARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the\nLicense for the specific language governing permissions and limitations under\nthe License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnickbutcher%2Fplaid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnickbutcher%2Fplaid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnickbutcher%2Fplaid/lists"}