grunt plugin for RTLCSS, a framework for transforming CSS from LTR to RTL.

Usage no npm install needed!

<script type="module">
  import gruntRtlcss from '';


GitHub version NPM version Build Status DEPENDENCIES


grunt plugin for RTLCSS, a framework for transforming CSS from LTR to RTL.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-rtlcss --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:



Run this task with the grunt rtlcss command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.



Description: Specifies RTLCSS options.

Type: Object


    "autoRename": false,
    "autoRenameStrict": false,
    "clean": true,
    "greedy": false,
    "processUrls": false,


Description: Specifies custom RTLCSS plugins.

Type: Array

Default: []

Description: Specifies whether to generate source maps or not, If you want more control over source map generation, you can define the map option as an object. (see postcss docs).

Type: Boolean or Object

Default: false


Description: Specifies whether to save unmodified files or not.

Type: Boolean

Default: true

Usage Example

rtlcss: {
    // task options
    options: {
      // generate source maps
      map: {inline: false},
      // rtlcss options
      opts: {
      // rtlcss plugins
      // save unmodified files
      saveUnmodified: true,
    expand : true,
    cwd    : 'ltr/',
    dest   : 'rtl/',
    src    : ['**/*.css']

Release History

  • v2.0.2 [23 Nov 2019]

    • Fail in case of CSS errors or inability to write output file.
  • v2.0.1 [18 Feb 2016]

    • Fix internal bug.
  • v2.0.0 [18 Feb 2016]

    • Upgrade to RTLCSS v2.x
    • options.config renamed to options.opts (avoids confusion with RTLCSS Config).
    • options.rules, options.declarations and removed in favor of the new options.plugins.

    RTLCSS options have changed, to view a summary of changes, see RTLCSS Upgrade guide.

  • v1.6.0 [15 Mar 2015]

    • Upgrade dependency (chalk v1.x.x).
  • v1.5.1 [14 Feb 2015]

    • Colorize log messages. Thanks @ocean90.
  • v1.5.0 [14 Feb 2015]

    • New option saveUnmodified:true to control whether to save unmodified files or not. Thanks @ocean90.
  • v1.4.0 [30 Jan 2015]

  • v1.3.0 [26 Oct 2014]

  • v1.2.0 [28 Sep 2014]

  • v1.1.0 [27 Sep 2014]

  • v1.0.0 [24 Aug 2014]

  • v0.7.0 [11 Aug 2014]

    • Remove duplicate postcss dependency.
    • Upgrade to RTLCSS v0.9.0
  • v0.6.0 [4 Jul 2014]

  • v0.5.0 [4 Jul 2014]

  • v0.4.1 [15 May 2014]

    • Add POSTCSS to dependencies list.
  • v0.4.0 [6 Apr. 2014]

  • v0.3.0 [5 Apr. 2014]

  • v0.2.0 [20 Mar. 2014]

    • Upgrade to RTLCSS v0.2.1
    • Support generating source maps.
  • v0.1.2 [7 Mar. 2014]

  • v0.1.1 [6 Mar. 2014]

    • Fix typo in
  • v0.1.0 [6 Mar. 2014]

    • Initial commit.