How InstantClick works

[This page duplicates the home page a lot, sorry about that; in the future I’ll remove those duplications from the home page and link to this page for more info.]

InstantClick has few differences from traditional web development, but it’s important to know them.

InstantClick eschews the browser’s page change cycle

The most important thing to understand is this: InstantClick technically makes your website a single-page application; the browser doesn’t change pages anymore, InstantClick does. This implies that:

The second most important thing to understand is that InstantClick only changes the <body> and <title>, so that your scripts are evaluated only once (this brings a nice, noticeable speed boost in and of itself).

Here is what all of this implies:

InstantClick is progressive enhancement: If a visitor’s browser doesn’t support InstantClick your site’s links will work as usual, just without a speed boost.

Documentation table of contents

Getting started

  • 1. Get started
  • 2. How InstantClick works
  • 3. Preloading
  • 4. Blacklisting
  • 5. Events and script re-evaluation
  • Go further