Skip to content

Commit

Permalink
First commit.
Browse files Browse the repository at this point in the history
  • Loading branch information
AdamMc331 committed Dec 11, 2015
0 parents commit 4920ee1
Show file tree
Hide file tree
Showing 56 changed files with 1,948 additions and 0 deletions.
8 changes: 8 additions & 0 deletions .gitignore
@@ -0,0 +1,8 @@
*.iml
.gradle
/local.properties
/.idea/workspace.xml
/.idea/libraries
.DS_Store
/build
/captures
1 change: 1 addition & 0 deletions .idea/.name

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

22 changes: 22 additions & 0 deletions .idea/compiler.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 3 additions & 0 deletions .idea/copyright/profiles_settings.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

18 changes: 18 additions & 0 deletions .idea/dictionaries/adammcneilly.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions .idea/encodings.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

25 changes: 25 additions & 0 deletions .idea/gradle.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

62 changes: 62 additions & 0 deletions .idea/misc.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

9 changes: 9 additions & 0 deletions .idea/modules.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 12 additions & 0 deletions .idea/runConfigurations.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

143 changes: 143 additions & 0 deletions README.md
@@ -0,0 +1,143 @@
Material Design Specs Library
=============

This library provides an easy and quick way to access the entire material design color pallete and elevation values, along with some neat helper methods like random access to material design colors.


Usage
-----

To have access to the library, add the dependency to your build.gradle:

```java

compile 'com.androidessence:materialdesignspecs:1.0.0'

```

Now, you'll be able to access the full color pallete from material design, either by XML, or programatically.

- **XML way**

```xml

<!-- You can use it in any view or other XML resources -->
<!-- Access the resources by using @color/ or @dimen/ -->
<View
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@color/mds_red_500"
android:elevation="@dimen/mds_elevation_card_resting"/>

```

- **Java way**

```java

// Access it through the android R file. Like the examples below.
R.color.mds_red_500
R.color.mds_blue_700
R.color.mds_pink_A100
R.color.mds_indigo_200
// Elevations
R.dimen.mds_elevation_card_resting
R.dimen.mds_elevation_dialog
R.dimen.mds_elevation_navigation_view
R.dimen.mds_elevation_menu

```

You'll also have access to some static helper methods like:

```java

getColorsByName(String colorName) // Returns a List<Integer> of colors with the given name.
// The methods below returns an Integer to use along your code.
getRandomColor()
getRandomNonAccentColor()
getRandomColorByLevel(String colorLevel)
getRandomColorByName(String colorName)
getRandomColorNonRepeating()
// And a few more!


```

Colors
-----

Here's the list of the colors names. Change "X" to the color level, like "50" or "A100".



- mds_red_X
- mds_pink_X
- mds_purple_X
- mds_deeppurple_X
- mds_indigo_X
- mds_blue_X
- mds_lightblue_X
- mds_cyan_X
- mds_teal_X
- mds_green_X
- mds_lightgreen_X
- mds_lime_X
- mds_yellow_X
- mds_amber_X
- mds_orange_X
- mds_deeporange_X
- mds_brown_X
- mds_grey_X
- mds_bluegrey_X

The color levels can be:

- 50
- 100
- 200
- 300
- 400
- 500
- 600
- 700
- 800
- 900

And the accent ones are:

- A100
- A200
- A400
- A700

Example of a color: `mds_orange_A400`.

**Reminder:** brown, grey, and bluegrey don't have accent colors.


Elevation values
-----

To know which elevation value to use, please refer to the [material design specs](https://www.google.com/design/spec/what-is-material/elevation-shadows.html#elevation-shadows-elevation-android-).

And with that you're all set. Go make some awesome apps with our lib :)

Credits & Contact
-----------------

Material Design Specs Lib was created with **<3** by:

- [Adam McNeilly](https://github.com/AdamMc331)
- [Maurício Pessoa](https://github.com/Mauker1)

And it's released under [Android Essence blog](http://androidessence.com/).

License
-------

Material Design Specs Lib is available under the [MIT License](https://opensource.org/licenses/MIT).

When you use it, don't forget to mention us ;)

Happy coding!
24 changes: 24 additions & 0 deletions build.gradle
@@ -0,0 +1,24 @@
// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.0.0-alpha1'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
classpath 'com.github.dcendents:android-maven-plugin:1.2'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}

allprojects {
repositories {
jcenter()
}
}

task clean(type: Delete) {
delete rootProject.buildDir
}
18 changes: 18 additions & 0 deletions gradle.properties
@@ -0,0 +1,18 @@
# Project-wide Gradle settings.

# IDE (e.g. Android Studio) users:
# Gradle settings configured through the IDE *will override*
# any settings specified in this file.

# For more details on how to configure your build environment visit
# http://www.gradle.org/docs/current/userguide/build_environment.html

# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for tweaking memory settings.
# Default value: -Xmx10248m -XX:MaxPermSize=256m
# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8

# When configured, Gradle will run in incubating parallel mode.
# This option should only be used with decoupled projects. More details, visit
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
# org.gradle.parallel=true
Binary file added gradle/wrapper/gradle-wrapper.jar
Binary file not shown.
6 changes: 6 additions & 0 deletions gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,6 @@
#Wed Oct 21 11:34:03 PDT 2015
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.8-all.zip

0 comments on commit 4920ee1

Please sign in to comment.