Transformicons

What's a transformicon?

It's an animated symbol/button/icon that morphs using a combination of SVG, CSS and HTML.

We also provide a builder that gives developers the ability to select their preferred Transformicons and output for finer control.

What browsers do you support?

IE10+, Chrome 36+, Safari 6+, Firefox 30+, Opera 22+, iOS 7+, Android 4+, Chrome for Android 38+

--

Documentation

All of our documentation has been written in markdown and can be directly viewed on our site or under our docs directory of this repo. Feel free to reach out for help in the issue tracker making sure to title your issue as descriptive as possible. Please make sure you've also checked older issues that may relate to your question first before filing in order to avoid bogging down the issue tracker.

--

Contributing

If you would like to contribute to the Transformicons project, please make sure that anything feature related is isolated to a new branch and titled with the name of the feature being developed.

Local installation is dead simple. We use all local files and directories to run this project. This ensures that you, the developer, need not install anything directly or globally to your system. Also, take note we use libsass for preprocessing all of our Sass code.

Install dependencies

$ npm install

Start a server and watch Sass files

$ npm start

Since a Sass coding guidelines document has been established by Hugo, it only seems fitting to abide loosely by it's suggestions. The http://sass-guidelin.es is what we strive towards as we write Sass and we hope you do the same. Enough said.

You'll find all our working files in the dist directory for Transformicons' JavaScript requirement and related Sass. Any markup for the Transformicons objects will be found in the site/templates/includes/tcons directory. We use assemble to build our markup so make sure you're never editing a file with the .html extension. Assemble files use the .hbs file extension. These are the files you should be editing instead.

Development

As you develop please keep in mind all our development work takes place on Transformicons' development branch. This is where you should branch off of when working on any bug fixes or features. For example…fork this project, branch off of development, and finally branch an additional time based on the topic you're working on. Pull Requests should be sent to the development branch instead of master in order to have finer control over our deployments and comitted code.

Transformicons Specs

Objects submitted to Transformicons must abide by the following guidelines in order to be accepted into the library…

• Fully Tested.
• Proportions must be a maximum of 40px wide and no more than 40px tall.
• Make sense to users and yourself.
• If your Transformicon is truly is a button please surround the object in a button tag otherwise use a span or div. See our documentation for examples.
• Provide custom control over color and appearance for traits such as border-radius. This way authors can control the visual aspect to match their design.

--

Noteworthy Mentions

• Featured resource in Codrops Collective #154
• Daily top 10 feature on Product Hunt

--

Props to @bennettfeely and @SaraSoueidan. Licensed under MIT