![Material](http://www.cosmicmind.io/MK/Material.png)

## Welcome to Material 2

Material is an animation and graphics framework.

## 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, 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.

## Our Mission

CosmicMind is setting out to build a seamless application platform, and Material is a major part of this effort. Material is the UI to our platform and will continue to advance itself through our growing community and project maintainers. We believe Material has a bright future and we are excited to openly share it with everyone.

## Features

- [x] Completely Customizable
- [x] Animations
- [x] Grid System
- [x] Layout Library
- [x] Color Library
- [x] Photo Library
- [x] Reminders
- [x] Photo & Video
- [x] Cards
- [x] Menus
- [x] Icons
- [x] Text
- [x] Navigation Controls
- [x] Example Projects
- [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.

## Examples

* Visit the [Examples](https://github.com/CosmicMind/Material/tree/master/Examples) directory to see example projects using Material.
* The [Installation](https://github.com/CosmicMind/Material/wiki/Installation) page has documentation on how to run example projects.

## Sticker Sheet

To help template your project, checkout Material Sticker Sheet.

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

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

## Material 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.io/gifs/MaterialColors.gif)

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

# Sample Components

The following are some sample components available within Material:

## Icons

Icons is a library of Google and CosmicMind icons that are available for use within your iOS applications. To help with icon choices, visit [materialicon.io](http://www.materialicon.io).

![Icon](http://www.cosmicmind.io/MK/MaterialMaterialIcon.png)

## Bar

A Bar is a foundation component that organizes a set of left and right views around a content area. Bars are great for building layouts that are combined with buttons and switches.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Bar)

## Button

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

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Button)

## Capture

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

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/CaptureController)

## Card

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Card)

## ImageCard

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/ImageCard)

## Presenter Card

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/PresenterCard)

## Layer

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Layer)

## Layout

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

![Material Image](http://www.cosmicmind.io/material/layout/images/cosmicmind_material_tools_layout.png)

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Layout)

## Menu Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/MenuController)

## Navigation Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/NavigationController)

## Navigation Drawer Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/NavigationDrawerController)

## Page Tab Bar Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/PageTabBarController)

## PhotoLibrary

PhotoLibrary is an API that simplifies iOS' Photos framework. It allows your application to integrate easily with your user's photo library, which gives you access to moments and albums.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/PhotoLibraryController)

## Reminders Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/RemindersController)

## Snackbar Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/SnackbarController)

## Switch

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/Switch)

## Toolbar Controller

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/ToolbarController)

## View

The Lorem Ipsum is simply dummy text of the composition and layout before printing. Lorem Ipsum is standard dummy text ever since the 1500s, when an unknown galley of type and scrambled to make a type specimen book fonts.

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

[Example Project](https://github.com/CosmicMind/Material/tree/development/Examples/Programmatic/View)

## License

Copyright (C) 2015 - 2016, Daniel Dahan and CosmicMind, Inc. <http://cosmicmind.io>. 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.
