![Material](http://www.cosmicmind.com/material/github/material-logo.png)

## Welcome to Material

Material is an animation and graphics framework that is used to create beautiful applications.

![Material Sample](http://cosmicmind.com/samples/github/page-tab-bar-controller-2.png)

* [Download the latest sample](https://github.com/CosmicMind/Samples/tree/master/Graph/CardTableView).

## About Material 2

The first version of Material was to bring Material Design to iOS. We considered that a great starting point, but not the entire story. Material 2 is the next chapter, which goes deeper into iOS with refined APIs that simplify Architecture, Photo Library, Reminders, Text Editing, Photo & Video, and much more. In addition to Material Design, we love Apple’s flat UI. Having this in mind, we made it possible to accomplish both UI styles with ease.

## Why A Separate Samples Repo?

We moved all sample projects to a separate repo named [Samples](https://github.com/CosmicMind/Samples) to allow their development to be independent of the Material framework. There has been instances where we needed to update the versions of the framework to accommodate changes that only occurred in the sample projects. 

## Features

- [x] Completely Customizable
- [x] Animations
- [x] Grid System
- [x] Layout Library
- [x] Color Library
- [x] Photo Library
- [x] Photo & Video
- [x] Cards
- [x] Menus
- [x] Icons
- [x] TextField
- [X] Snackbar
- [x] TabBar
- [x] PageTabBar
- [X] SearchBar
- [x] NavigationController
- [x] NavigationDrawer
- [x] BottomNavigationBar
- [x] Sample Projects
- [x] And More...

## Releasing January 2017 - Material 2.5.0

- [x] Reminders
- [x] Text Editor
- [x] Toasts
- [x] Dialogs & Alerts
- [x] Bottom Sheets
- [x] Transitions
- [x] Updated Motion API
- [x] And More...

## Requirements

* iOS 8.0+ / Mac OS X 10.9+
* Xcode 8.0+

## Communication

- If you **need help**, use [Stack Overflow](http://stackoverflow.com/questions/tagged/cosmicmind). (Tag 'cosmicmind')
- If you'd like to **ask a general question**, use [Stack Overflow](http://stackoverflow.com/questions/tagged/cosmicmind).
- If you **found a bug**, _and can provide steps to reliably reproduce it_, open an issue.
- If you **have a feature request**, open an issue.
- If you **want to contribute**, submit a pull request.

## Installation

> **Embedded frameworks require a minimum deployment target of iOS 8 or OS X Mavericks (10.9).**
> - [Download Material](https://github.com/CosmicMind/Material/archive/master.zip)

Visit the [Installation](https://github.com/CosmicMind/Material/wiki/Installation) page to learn how to install Material using [CocoaPods](http://cocoapods.org) and [Carthage](https://github.com/Carthage/Carthage).

## Changelog

Material is a growing project and will encounter changes throughout its development. It is recommended that the [Changelog](https://github.com/CosmicMind/Material/wiki/Changelog) be reviewed prior to updating versions.

# Samples

The following are samples to see how Material may be used within your applications.

* Visit the [Samples](https://github.com/CosmicMind/Samples) repo to see sample projects using Graph.

## Icons

Icons is a library of Google and CosmicMind icons that are available for use within your iOS applications.

![Icon](http://www.cosmicmind.com/gifs/marketplace/icons.png)

[Learn More](http://cosmicmind.com/material/icons)

## Colors

Try the Material Colors app to see the wonderful colors available in Material, or use the online version at [MaterialColors.io](http://materialcolors.io).

![MaterialColors](http://www.cosmicmind.com/gifs/shared/colors.gif)

[Get Material Colors on the AppStore](https://itunes.apple.com/app/x/id1111994400?mt=8)

## TextField

A TextField is an excellent way to improve UX. It allows for a placeholder and additional hint details.

![TextField](http://www.cosmicmind.com/gifs/white/text-field.gif)

* Download the complete [TextField sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/TextField).
* Learn more about [TextField](http://cosmicmind.com/material/textfield).


## Button

A button is used to trigger an action through a touch event. Material comes with a foundational button, and 4 specialized buttons that can be stylized in any way.

![Material Image](http://www.cosmicmind.com/material/white/button.gif)

* Download the complete [Button sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/Button).
* Learn more about [Button](http://cosmicmind.com/material/button).


## Switch

A switch is a control component that toggles between on and off states.

![Material Image](http://www.cosmicmind.com/material/white/switch.gif)

* Download the complete [Switch sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/Switch).
* Learn more about [Switch](http://cosmicmind.com/material/switch).


## Card

A Card is a flexible component that may be configured in any way you like. It has a Toolbar, Bar, and content area that may utilize any UIView type.

![Material Image](http://www.cosmicmind.com/gifs/white/card.gif)

* Download the complete [Card sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/Card).
* Learn more about [Card](http://cosmicmind.com/material/card).


## ImageCard

An ImageCard is an expansion of the base Card. The Toolbar overlays an image area that sits above the dynamic content area.

![Material Image](http://www.cosmicmind.com/gifs/white/image-card.gif)

* Download the complete [ImageCard sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/ImageCard).
* Learn more about [ImageCard](http://cosmicmind.com/material/imagecard).
* Learn how to make the ImageCard data-driven with [Graph's ImageCard sample](https://github.com/CosmicMind/Samples/tree/master/Graph/ImageCard).


## PresenterCard

The PresenterCard is a completely new card style. It allows for a primary presentation area that may be any UIView type in addition to the content area, Toolbar, and Bar components. The options for this card are endless.

![Material Image](http://www.cosmicmind.com/gifs/white/presenter-card.gif)

* Download the complete [PresenterCard sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/PresenterCard).
* Learn more about [PresenterCard](http://cosmicmind.com/material/presentercard).


## Menu

A Menu manages a collection of views. A new MenuItem type has been added that manages a title and button to improve UX and visual beauty.

![Material Image](http://www.cosmicmind.com/material/white/menu-controller.gif)

* Download the complete [Menu sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/MenuController).
* Learn more about [Menu](http://cosmicmind.com/material/menu).


## Toolbar

Toolbars are super flexible and add excellent control to your navigation flow. They manage a set of left and right views with auto aligning title and detail labels.

![Material Image](http://www.cosmicmind.com/gifs/white/toolbar-controller.gif)

* Download the complete [Toolbar sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/ToolbarController).
* Learn more about [Toolbar](http://cosmicmind.com/material/toolbar).


## SearchBar

A SearchBar is a powerful navigation tool that allows for user's input with an instant visual response. A set of left and right views may be added to expand functionality.

![Material Image](http://www.cosmicmind.com/gifs/shared/search-bar-controller.gif)

* Download the complete [SearchBar sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/SearchBarController).
* Learn more about [SearchBar](http://cosmicmind.com/material/searchbar).
* Learn how to make the SearchBar data-driven with [Graph's Search sample](https://github.com/CosmicMind/Samples/tree/master/Graph/Search).


## PageTabBar

A PageTabBar is a new component that links a customizable TabBar to a UIPageViewController making a powerful and visually pleasing component to have in any application. The TabBar can be aligned at the top or bottom of the view controller.

![Material Image](http://www.cosmicmind.com/material/white/page-tab-bar-controller.gif)

* Download the complete [PageTabBar sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/PageTabBarController).
* Learn more about [PageTabBar](http://cosmicmind.com/material/pagetabbar).


## NavigationController

A NavigationController is a specialized view controller that manages a hierarchy of content efficiently, making it easier for users to move within an application.

![Material Image](http://www.cosmicmind.com/gifs/white/navigation-controller.gif)

* Download the complete [NavigationController sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/NavigationController).
* Learn more about [NavigationController](http://cosmicmind.com/material/navigationcontroller).


## NavigationDrawer

A NavigationDrawer slides in from the left or right and contains the navigation destinations for your application.

![Material Image](http://www.cosmicmind.com/material/shared/navigation-drawer-controller.gif)

* Download the complete [NavigationDrawer sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/NavigationDrawerController).
* Learn more about [NavigationDrawer](http://cosmicmind.com/material/navigationdrawer).


## Snackbar

A Snackbar is a new component that is very simple in its behavior and very powerful in its message. It can be used application wide, or isolated to specific view controllers.

![Material Image](http://www.cosmicmind.com/material/white/snackbar-controller.gif)

* Download the complete [Snackbar sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/SnackbarController).
* Learn more about [Snackbar](http://cosmicmind.com/material/snackbar).


## PhotoLibrary

PhotoLibrary is a new component that simplifies the Photos framework and allows for beautiful photos found in the Photos application to be used within your application.

![Material Image](http://www.cosmicmind.com/material/shared/photolibrary-controller.png)

* Download the complete [PhotoLibrary sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/PhotoLibraryController).
* Learn more about [PhotoLibrary](http://cosmicmind.com/material/photolibrary).


## Capture

Capture is an API that simplifies iOS' AVFoundation framework. It allows for photos and video to easily be captured while managing all the complexities.

![Material Image](http://www.cosmicmind.com/material/shared/capture-controller.png)

* Download the complete [Capture sample](https://github.com/CosmicMind/Samples/tree/master/Material/Programmatic/CaptureController).
* Learn more about [Capture](http://cosmicmind.com/material/capture).


## Sticker Sheet

To help template your project, checkout Material Sticker Sheet.

![MaterialStickerSheet](http://www.cosmicmind.com/MK/material_iso_1.png)

[Get Material Sticker Sheet](http://www.materialup.com/posts/material-design-sticker-sheets)


## Much More...

So much more inside. Enjoy!

## License

Copyright (C) 2015 - 2017, Daniel Dahan and CosmicMind, Inc. <http://cosmicmind.com>. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

*   Redistributions of source code must retain the above copyright notice, this     
    list of conditions and the following disclaimer.

*   Redistributions in binary form must reproduce the above copyright notice,
    this list of conditions and the following disclaimer in the documentation
    and/or other materials provided with the distribution.

*   Neither the name of CosmicMind nor the names of its
    contributors may be used to endorse or promote products derived from
    this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
