Intro

• Fork of mbitson/mcg hosted at mcg.mbitson.com, which as of Nov 2024 is offline
• At present the upstream repo won't build due to a dependency issue, addressed in this fork
• In lieu of normal service at mcg.mbitson.com being resumed, the service can be accessed by:
  • Visiting a deployment of this fork on GitHub Pages here
  • Running the fork locally

Running Locally

• Checkout this repo
• In project folder run:
  • npm install
  • npm run start
• Open browser at http://localhost:3000/

Material Design Color Generator

http://mcg.mbitson.com/

A tool for generating a color palette for Material Design. Supports exporting to and importing from various Material Design frameworks and toolkits.

• Screenshot
• Supported Frameworks & Tools
• Color Generation
• What's New?
• Bugs & Questions
• Planned Enhancements
• Contributions

Screenshot

Supported Frameworks & Tools

This palette generation tool supports both exporting and importing palettes for the following frameworks and tools:

1. Android XML
2. AngularJS (Material)
3. AngularJS 2 (Material 2)
4. Ember Paper
5. Material Design Lite (SCSS)
6. Material UI (React)
7. Material UI Next (React)
8. Vue.js Material Design
9. Flutter
10. MCG Reimport (Proprietary)

When importing code, please ensure that it was code generated with this tool. In many cases, code generated outside of this tool should work as well, however this is unreliable.

Color Generation

By default, we've chosen an Algorithm that seems to do a decent job at picking colors in most situations. However, if you find your palette doesn't look quite how you'd expect, you may change the algorithm that is used. Options are:

• "Traditional" is the original MCG logic. It is currently the default. It creates a lower contrast palette.
• "Constantin" is the logic that was developed based on the outline from here. It creates a higher contrast palette.
• "Buckner" is a slight variation in "Constantin" focusing on the A100 - A700 hues.

What's New?

Please see the CHANGELOG.

Bugs & Questions

Should you encounter a bug/problem or have a question about the tool please report it using GitHub's "Issues" feature here.

Planned Enhancements

• (TOP) Determine which palette is primary, secondary, and so on. Drag and drop palettes.
• (MED) Remove individual color's hex details and create tooltip styled with all color details. (Hoverintent, populated only once it's opening, includes hex, rgb, cmyk, saturation, brightness. Possibly obtained using tinycolor)
• (MED) Improve performance by dynamically creating and destroying the color picker button and UI instead of loading a ton of Divs into the DOM for each color on the screen and hiding them.
• (LOW) Add reset buttons for each individual color in a palette (based on main palette color)
• (LOW) Create UI for more than 5 palettes (and/or alert user about dangers of using this many palettes)

Contributions

• fireflight1 - Initial concept, starting code base.
• tkh44 - Optimizations/fixes
• simon04 - Contrast detection, bug fixes.
• Constantin - Color algorithm logic per stack overflow answer here.
• tabuckner - Slight variation in 'Constantin' focusing on the A100 - A700 values.
• vstollen - Added generators necessary to support Flutter
• berryp - Bugfixes on Flutter support