npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

grunt-laxar-compass

v0.3.0

Published

Watches SCSS of LaxarJS artifacts, runs compass when needed.

Downloads

8

Readme

grunt-laxar-compass Build Status

Watches SCSS of LaxarJS artifacts, runs compass when SCSS changes.

These tasks makes it easy to use compass in LaxarJS applications.

There is a task that watches your SCSS files while the development server is running, and a task to manually compile SCSS.

Whenever you change SCSS for an artifact, the CSS for the same theme folder of the artifact gets recreated using compass compile. The configuration path will be set to the compass/config.rb from the matching global theme folder (e.g. includes/themes/my.theme/config/compass.rb). Also, when you modify the default.theme SCSS of an artifact, all other themes of that artifact are recompiled, because they usually import the default theme.

For this to work with your theme, make sure that it contains a compass/config.rb file.

Getting Started

This plugin is designed to be used with grunt-laxar v1.1.0 or later.

To use this plugin, you first need to install it using npm:

$ npm install grunt-laxar-compass

After that, load its tasks from your Gruntfile:

grunt.loadNpmTasks( 'grunt-laxar-compass' );

Finally, configure laxar-compass as a user task for the build stage:

grunt.initConfig( {
   // ...
   'laxar-configure': {
      // ...
      options: {
         userTasks: {
            'build-flow': [ 'laxar-compass-flow' ]
         }
      }
   },
   'laxar-compass': {
      options: {
         // optional:
         compass: 'path/to/compass'
      }
   }
}

This will automatically launch the task during development (e.g. grunt develop), watching your application artifacts.

CLI Tasks

The plugin provides a task which is intended for use on the command line:

laxar-compass

Compile SCSS for a given artifacts or for all artifacts, in a selected theme or in all themes.

For more information, run grunt laxar-compass --usage.

User Tasks

This plugin makes available a new user task for the build-stage of the grunt-laxar task laxar-configure.

laxar-compass-flow

This multi-task configures the watch task to keep an eye on the SCSS of widgets, controls and themes for a given flow target. Whenever the SCSS changes, compass compile is executed with the config.rb of the theme. This only actually works if watch is used, e.g (for a flow-target main):

$ grunt laxar-configure laxar-compass-flow:main watch

or simply

grunt laxar-develop

which will also run a development server with live-reload.

Options

  • compass

The path to the compass executable (relative or absolute). If omitted, compass must exist on the path. This option can be overridden on the command line using the argument grunt develop --laxar-compass my/path/to/compass.

  • debounceDelay

Subsequent changes within this time window will be batched together before running compass. The default is 50 milliseconds. This is useful if several files are changes within a short duration (e.g. saving multiple editor tabs together).