--- /dev/null
+[![Build Status](https://travis-ci.org/cssjanus/php-cssjanus.svg?branch=master)](https://travis-ci.org/cssjanus/php-cssjanus) [![Packagist](https://img.shields.io/packagist/v/cssjanus/cssjanus.svg?style=flat)](https://packagist.org/packages/cssjanus/cssjanus)
+
+# CSSJanus
+
+Convert CSS stylesheets between left-to-right and right-to-left.
+
+## Basic usage
+
+```php
+$rtlCss = CSSJanus::transform( $ltrCss );
+```
+
+## Advanced usage
+
+``transform( $css, $swapLtrRtlInURL = false, $swapLeftRightInURL = false )``
+
+* ``$css`` (string) Stylesheet to transform
+* ``$swapLtrRtlInURL`` (boolean) Swap 'ltr' and 'rtl' in URLs
+* ``$swapLeftRightInURL`` (boolean) Swap 'left' and 'right' in URLs
+
+### Preventing flipping
+
+Use a ```/* @noflip */``` comment to protect a rule from being changed.
+
+```css
+.rule1 {
+ /* Will be converted to margin-right */
+ margin-left: 1em;
+}
+/* @noflip */
+.rule2 {
+ /* Will be preserved as margin-left */
+ margin-left: 1em;
+}
+```
+
+## Port
+
+This is a PHP port of the Node.js implementation of CSSJanus.
+
+Feature requests and bugs related to the actual CSS transformation or test
+cases of it, should be submitted upstream at
+<https://github.com/cssjanus/cssjanus>.
+
+Upstream releases will be ported here.