Modular and customizable Material Design UI components for iOS
Objective-C Swift Python Shell Ruby C
Clone or download
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Revert "Add team handbook bug template (#4210)" May 22, 2018
catalog [Catalog] Enable AppBar's isTopLayoutGuideAdjustmentEnabled in all ex… Jul 12, 2018
components [ActivityIndicator] Removed outdated comment. (#4561) Jul 13, 2018
contributing Update releasing.md (#4423) Jun 21, 2018
demos Bumped version number to 57.0.0. Jul 11, 2018
docs Remove outdated tutorial (#3722) May 4, 2018
scripts [Codelabs] Add build tests for codelabs (#4494) Jul 12, 2018
.arclint Add autoresizingMask to list of line length exceptions. Apr 26, 2016
.arcunit Only run unit tests when component src or tests change. Apr 12, 2016
.clang-format Added include sorting to clang-format. Jun 17, 2016
.codecov.yml Add Codecov config to exclude uninteresting paths. (#1118) Dec 28, 2016
.gitignore Ignore gh-pages. May 30, 2018
.gitmodules [Catalog] Remove EarlGrey tests. (#4378) Jun 7, 2018
.kokoro [kokoro] Make the private component rewrite rules more generic. (#4294) May 30, 2018
.mdc-docsite.yml [Docs] Adds API documentation roots and tidies up here and there. (#1425 May 12, 2017
.swift-version Fixed mysterious CocoaPods header_mapping_dir issue that was blocking… Dec 15, 2016
.swiftlint.yml More SwiftLint fixes for unit tests and example apps. (#1154) Jan 11, 2017
.travis.yml [travis] Remove pod lib lint step. (#3323) Apr 11, 2018
AUTHORS Adding AUTHORS and removing CONTRIBUTORS.txt. Aug 8, 2016
BUILD Initial addition of kokoro and bazel continuous integration support. (#… Nov 1, 2017
CHANGELOG.md updated the CHANGELOG Jul 11, 2018
CODEOWNERS update codeowners (#4445) Jun 28, 2018
CODE_OF_CONDUCT.md Added GitHub preferred code of conduct file. (#1642) Jul 13, 2017
CONTRIBUTING.md [Contributing] Cleaning up link Dec 14, 2016
ISSUE_TEMPLATE.md [Docs] New all CTA Issue template (#1051) Dec 14, 2016
LICENSE Adding AUTHORS and removing CONTRIBUTORS.txt. Aug 8, 2016
MaterialComponents.podspec Bumped version number to 57.0.0. Jul 11, 2018
MaterialComponentsEarlGreyTests.podspec Bumped version number to 57.0.0. Jul 11, 2018
MaterialComponentsExamples.podspec Bumped version number to 57.0.0. Jul 11, 2018
MaterialComponentsUnitTests.podspec Bumped version number to 57.0.0. Jul 11, 2018
PULL_REQUEST_TEMPLATE.md [Docs] Correcting PR template (#3031) Mar 6, 2018
README.md Remove outdated tutorial (#3722) May 4, 2018
ROADMAP.md [Docs] Roadmap update (#1065) Dec 14, 2016
VERSION Bumped version number to 57.0.0. Jul 11, 2018
WORKSPACE Update bazel workspace and version to latest. (#3052) Mar 7, 2018
material_components_ios.bzl [BottomSheet] [1/3] Split out ios_runners() into //components/testing… Apr 23, 2018
mdc_hero.png [Docs] Add hero image to top-level README.md (#1100) Dec 21, 2016

README.md

Material Components for iOS

Build Status Code coverage Chat

Material Components for iOS (MDC-iOS) helps developers execute Material Design. Developed by a core team of engineers and UX designers at Google, these components enable a reliable development workflow to build beautiful and functional iOS apps. Learn more about how Material Components for iOS supports design and usability best practices across platforms in the Material Design Platform Adaptation guidelines.

Material Components for iOS are written in Objective-C and support Swift and Interface Builder.

Useful Links

Trying out Material Components

CocoaPods is the easiest way to get started (if you're new to CocoaPods, check out their getting started documentation.)

To install CocoaPods, run the following commands:

sudo gem install cocoapods

Our catalog showcases Material Components. You can use the pod try command from anywhere on your machine to try the components, even if you haven't checked out the repo yet:

pod try MaterialComponents

In case you have already checked out the repo, run the following command:

pod install --project-directory=catalog/

The component implementations can be found in Xcode within Pods > Development Pods > MaterialComponents.

Requirements

  • Xcode 8.3.3 or higher.
  • Minimum iOS deployment target of 8.0 or higher
  • CocoaPods

Attributions

Material Components for iOS uses Material Design icons, copyright Google Inc. and licensed under CC BY 4.0.

Several components use MDFTextAccessibility, copyright Google Inc. and licensed under Apache 2.0 without a NOTICE file.

MDCCatalog uses the Roboto font, copyright 2011 Google Inc. and licensed under Apache 2.0 without a NOTICE file.