Hysen Labs
Open-source project
alvarotrigo/fullPage.js avatar
alvarotrigo

fullPage.js

fullPage plugin by Alvaro Trigo. Create full screen pages fast and simple

35,412 stars7,104 forksJavaScriptGPL-3.0
01
DEEP OPEN-SOURCE ANALYSIS

How fullPage.js makes fullscreen scrolling sites

Ever scrolled a site that slides between full screen sections? That is fullPage.js: a small JavaScript library that also adds horizontal sliders inside each section.

02
DEEP OPEN-SOURCE ANALYSIS

What it does

fullPage.js, by Alvaro Trigo, is described as a simple and easy to use library that creates fullscreen scrolling websites, also known as single page or onepage sites. It adds horizontal sliders inside the sections of the site. The README claims it is fully functional on all modern browsers and with IE 11, with touch support for mobile phones, tablets, and touch screen computers. Anyone stuck on older IE is told to fall back to fullPage.js v3.

03
DEEP OPEN-SOURCE ANALYSIS

The files you include

Usage is laid out step by step. You include the JavaScript file, fullpage.js or the minified version, plus the CSS file fullpage.css. An easings file is optional when you run with css3:false and want other easing effects. The README covers module loaders like Webpack, Browserify, and Require.js, and CDN delivery through JSDelivr, UNPKG, CDNJS, and others. The HTML structure matters too: a doctype on the first line, sections carrying a section class, a wrapper that cannot be the body element, and an active class to pick the starting point.

04
DEEP OPEN-SOURCE ANALYSIS

Licensing is the part to read

The project ships under GPL-3.0, and the README spells out both sides of the license story. For open source apps under a GPLv3 compatible license, you may use it under the GPLv3, but you must provide a prominent notice that fullPage.js is in use and keep the credit comments in the JavaScript and CSS files intact, even after minification. For proprietary work, there is a separate commercial license that keeps your source code closed, with a purchase link provided.

05
DEEP OPEN-SOURCE ANALYSIS

Beyond the basics

Several advanced options get dedicated sections. Anchor links let you navigate straight to a section or slide using the anchors option or a data-anchor attribute. Smaller or bigger sections are possible with the fp-auto-height class, and a responsive variant switches to content sized height once responsive mode kicks in. Lazy loading loads images, videos, and audio only when they enter the viewport by swapping src for data-src. Extensions exist too, but each one needs an activation key and a license key.

06
DEEP OPEN-SOURCE ANALYSIS

Plugins and demos

The top of the README links to an online demo, a CodePen, and WordPress plugins for Gutenberg and Elementor. There is also a migration guide from fullPage v3 to fullPage v4 for anyone upgrading. Those extras sit alongside the core library documentation, which runs long, mostly because of the many configuration options and state classes that fullpage.js adds to the page.

08
DEEP OPEN-SOURCE ANALYSIS

Official sources

09
Community notes

Community notes