Skip to main content
Settings
Color Mode
Theme Skin
Background

Appearance preferences are saved in this browser only.

Environment
Current Environment Production

Built with JEKYLL_ENV=production. Changes require deployment.

Theme & Build
Jekyll v3.10.0
Last Build Jul 07, 04:03
Page Location
Page Info
Layout default
Collection docs
Path _docs/features/particles-background.md
URL /docs/features/particles-background/
Date 2026-07-07

Particles Background

Interactive particle animation background using particles.js for visual enhancement on landing and hero sections.

Table of Contents

Particles Background

An optional animated particle field that sits behind hero and landing content, adding subtle motion and depth. Particles drift, connect, and react to the cursor, and the whole effect is configured from a single JSON file.

Overview

  • Configurable particle field — count, size, speed, colour, and link distance are all data-driven.
  • Interactive — particles respond to mouse hover and clicks.
  • JSON configuration — behaviour is read from assets/particles.json, so you can retune the look without touching JavaScript.
  • Performance-conscious — intended for landing/hero sections rather than every page, so the animation cost is scoped to where it adds value.

How it works

The vendored assets/js/particles.js runtime renders onto a canvas mounted in the hero area; the initialiser (assets/js/particles-source.js) loads assets/particles.json and applies it. Because the configuration is external, a site can ship a calmer or denser field by editing the JSON alone.

Implementation

File Role
assets/js/particles.js Vendored particles.js renderer.
assets/js/particles-source.js Initialiser that loads the JSON config and mounts the canvas.
assets/particles.json Particle count, motion, colours, and interactivity.