Socket
Socket
Sign inDemoInstall

critical

Package Overview
Dependencies
122
Maintainers
1
Versions
109
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    critical

Critical-path CSS generation & inlining


Version published
Maintainers
1
Created

Changelog

Source

v0.1.0 / 2014-06-30

  • Consistency of example order
  • Add minification for inline styles
  • Fix some style, cb issues
  • Revisions for minification
  • Add support for minification
  • Add options to readme
  • Fixes #9 - adds defaults for w/h
  • Add note about FAQs, license
  • Expand on joined paths
  • Move reads
  • Improve test descriptions
  • Improve callbacks, add more tests
  • Fixes #2, passes errors
  • Path joins for #6, test > fixture for #10, other fixes
  • Fixes #4 - drop log statements
  • Fixes #5 - switch to readFile/writeFile only
  • Fixes #7 - throw if src/base not specified
  • Should fix #1 - only write to disk if dest specified
  • Switch to integers
  • Readme revisions

Readme

Source

critical

Critical Path CSS generation & inlining

Installation

npm install -g critical

Usage

Include:

var critical = require('critical');

###Generate critical-path CSS

Basic usage:

critical.generate({
	  base: 'test/',
	  src: 'index.html',
	  dest: 'styles/main.css',
	  width: 320,
	  height: 480,
	});

Generate and minify critical-path CSS:

critical.generate({
	  base: 'test/',
	  src: 'index.html',
	  width: 320,
	  dest: 'styles/styles.min.css',
	  minify: true,
	  height: 480
	});

Generate and return output via a callback:

critical.generate({
	  base: 'test/',
	  src: 'index.html',
	  width: 320,
	  height: 480,
	}, function (err, output){
		// You now have critical-path CSS
		// Works with and without dest specified
	});

###Inline <style> / critical CSS from generation

Basic usage:

critical.inline({
	  base: 'test/',
	  src: 'index-critical.html',
	  dest: 'inlined.html'
	});

Minify and inline stylesheets:

critical.inline({
	  base: 'test/',
	  src: 'index-critical.html',
	  dest: 'inlined-minified.html',
	  minify: true
	});

Inline and return output via a callback:

critical.inline({
	  base: 'test/',
	  src: 'index-critical.html',
	}, function (err, output){
		// You now have HTML with inlined critical-path CSS
		// Works with and without dest specified
	});

###Options

####base Type: String

Base directory in which the source and destination are to be written.

####src Type: String

Location of the HTML source to be operated against.

####dest Type: String

Location of where to save the output of an operation.

####width Type: integer

(Generation only) Width of the target viewport.

####height Type: integer

(Generation only) Height of the target viewport.

####minify Type: boolean

Enable minification of CSS output

Why?

Why is critical-path CSS important?

CSS is required to construct the render tree for your pages and JavaScript will often block on CSS during initial construction of the page. You should ensure that any non-essential CSS is marked as non-critical (e.g. print and other media queries), and that the amount of critical CSS and the time to deliver it is as small as possible.

Why should critical-path CSS be inlined?

For best performance, you may want to consider inlining the critical CSS directly into the HTML document. This eliminates additional roundtrips in the critical path and if done correctly can be used to deliver a “one roundtrip” critical path length where only the HTML is a blocking resource.

FAQ

When should I just use Penthouse directly?

I recommend using Penthouse directly if your app has a large number of styles or stylesheets being dynamically injected into the DOM. Critical is best used when your page uses a fixed set of stylesheets as we can automatically scrape this for you, avoiding the overhead of passing known styles yourself manually to Penthouse.

License

Apache 2.0
Copyright 2014 Google Inc

Keywords

FAQs

Last updated on 30 Jun 2014

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc