Loading
Loading
Loading
mobile footer

Build the Interaction Layer Your Website is Missing.

Browse All EffectsBrowse All EffectsBrowse All EffectsUpgrade to ProUpgrade to ProUpgrade to Pro

70+ effects free, forever. No credit card.

© 2026 Hyperiux. All Rights Reserved.

AI Component CatalogueHey AI, Learn About Us
Platform

Vault

  • Documentation
  • Pricing
  • Blog
  • Community
  • NPM
  • MCP

Categories

  • All Effects
  • WebGL
  • Text
  • Backgrounds
  • Buttons
  • Carousels
  • Scroll
  • Components
  • Navigation
  • Cursor
  • Transitions
  • Loaders

Documents

  • Introduction
  • Installation
  • CLI
  • Dependencies
  • License

Legal

  • License Agreement
  • Terms of Service
  • Privacy Policy
  • Refund Policy
Socials
  • Twitter / X
  • LinkedIn
  • GitHub
  • Instagram
Contact Us
  • hello@hyperiux.com
New effects, in your inbox

Every new drop, plus the occasional behind-the-scenes build. No spam. Unsubscribe anytime.

All Effects
Featured ComponentsText AnimationsAnimated BackgroundsAnimated ButtonsCarousel EffectsScroll EffectsCreative ComponentsNavigationsCursor EffectsTransitionsLoadersWebGL & 3D Effects
Templates
IntroductionInstallationCLIDependenciesLicense
PricingBlogGithubNPMMCP Doc
Loading
Home/effects/Colliding Models

Colliding Models

Let 3D objects move, collide, and react inside a WebGL scene so the page feels kinetic instead of merely decorated.

Three.js@react-three/fiber@react-three/drei@react-three/rapier@react-three/postprocessingpostprocessingmaath
DemoDemoDemo

Tune the Real Props

Background Color

Overview

Colliding Models turns a WebGL scene into a field of physical interaction. Objects do not just float; they meet, bounce, and spark.

Use Colliding Models when a brand wants motion that feels kinetic rather than ornamental. It belongs on creative studio pages, 3D capability sections, AI/cyber launches, and experimental homepages where object interaction supports the message. The page job is energy: visitors should feel the system reacting without losing the headline or CTA.

The production risk is control. Physics scenes can become chaos if collision count, object scale, pointer force, and postprocessing are not kept in check. The scene should feel alive, not like a drawer of logos got thrown down a staircase.


Usage Code

page
1import CollidingModels from "@/components/effects/colliding-models";2 3const page = () => {4  return (5    <>6        <CollidingModels />7    </>8  );9};10 11export default page;

Example Production Use Case

A creative technology studio can use Colliding Models on a capability page to show that the team builds interactive 3D systems, not just static scenes. Visitors move through the field, objects collide, and a click changes the spark. The outcome is energy: the page demonstrates interaction as the service promise.


Best Used For

  • Creative studio and WebGL capability pages where interaction proves the point.
  • Brand heroes that need kinetic objects rather than passive decorative shapes.
  • Experimental pages where pointer or click input can safely enhance the scene.

Not For

Not for product flows, forms, documentation, checkout, or pages where users need quiet reading and precise clicking.

Not for large model sets without a strict physics and rendering budget.


Performance Budget

Use lightweight models, simple colliders, capped DPR, limited postprocessing, and offscreen pause. Keep physics bodies predictable and avoid simulating more objects than the page can justify.


Accessibility and Mobile

The 3D field should be optional. Keep the message, CTA, and navigation outside the canvas. On mobile, reduce physics, simplify interaction, or use a static poster. Colliding Models has no reduced-motion mode, so the physics keeps running and reacting to the cursor for every visitor.


Common Mistakes

  • Letting physics objects cover the CTA.
  • Using detailed mesh colliders where simple collision shapes would do.
  • Making click/tap interaction essential to understanding the page.

Changelog

Added a reduced-motion notice and wired connectorCount, gravity, modelScale, and backgroundColor into the live scene.
Initial release

API Reference

PropTypeDefaultDescription
geometrystringmodelShape of the colliding pieces: the Hyperiux logo model or a built-in geometry.
connectorCountnumber8Number of connecting shapes or joints.
modelScalenumber1Scale applied to the 3D model.
backgroundColorstring#141518Canvas background color.
returnToPositionbooleantruePull pieces back to the cluster after the cursor knocks them away.
returnSpeednumber1How quickly knocked pieces come back to the cluster.

Questions, Answered.

When should I use Colliding Models?

Use it when a WebGL page needs physical interaction, collisions, and object energy to support a brand or capability message.

Does Colliding Models need real 3D assets?

Yes, if the scene is model-led. Keep assets optimized, compressed, and built with collision needs in mind rather than importing heavy showcase models blindly.

How should the physics stay performant?

Use simple colliders, limited object counts, capped DPR, paused offscreen simulation, and cleanup on route change. Physics should enhance the scene, not become the product.

What should click or tap do?

Click or tap can change color, spark, material, or impulse, but it should remain optional. Core content must stay available without interacting with the scene.

What is the reduced-motion fallback?

There isn't one. Colliding Models runs a live physics simulation that keeps reacting to the cursor, since that motion is the whole effect.

Can Hyperiux adapt Colliding Models for a real brand system?

Yes. A custom version should define model style, collision behavior, interaction rules, render budget, fallback design, source handoff, and implementation notes.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Dotted Grid Background
canvas

Dotted Grid Background

Backgrounds

Donut Particles
Pro
Three.js@react-three/fiber

Donut Particles

WebGL

Book Flip
Pro
Three.js@react-three/fiber@react-three/drei

Book Flip

WebGL

Fractal Glass
Three.js

Fractal Glass

WebGL

Grid Lift
Pro
canvas

Grid Lift

Backgrounds