Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

react-confetti

alampros11.4mMIT6.4.0TypeScript support: included

React component to draw confetti for your party.

react, confetti, component, react-component

readme

react-confetti

Confetti without the cleanup. Demo

Build Status npm npm bundle size npm type definitions

Based on a pen by @Gthibaud: https://codepen.io/Gthibaud/pen/ENzXbp

demogif

Install

npm install react-confetti

Use

width and height props are recommended. They will default to the initial window dimensions, but will not respond to resize events. It is recommended to provide the dimensions yourself. Here is an example using a hook:

import React from 'react'
import { useWindowSize } from 'react-use'
import Confetti from 'react-confetti'

export default () => {
  const { width, height } = useWindowSize()
  return (
    <Confetti
      width={width}
      height={height}
    />
  )
}

Props

Property Type Default Description
width Number window.innerWidth || 300 Width of the <canvas> element.
height Number window.innerHeight || 200 Height of the <canvas> element.
numberOfPieces Number 200 Number of confetti pieces at one time.
confettiSource { x: Number, y: Number, w: Number, h: Number } {x: 0, y: 0, w: canvas.width, h:0} Rectangle where the confetti should spawn. Default is across the top.
friction Number 0.99
wind Number 0
gravity Number 0.1
initialVelocityX Number | { min: Number, max: Number } 4 Range of values between which confetti is emitted horizontally, positive numbers being rightward, and negative numbers being leftward. Giving a number x is equivalent to giving a range { min: -x, max: x }.
initialVelocityY Number | { min: Number, max: Number } 10 Range of values between which confetti is emitted vertically, positive numbers being downward, and negative numbers being upward. Giving a number y is equivalent to giving a range { min: -y, max: 0 }.
colors String[] ['#f44336'
'#e91e63'
'#9c27b0'
'#673ab7'
'#3f51b5'
'#2196f3'
'#03a9f4'
'#00bcd4'
'#009688'
'#4CAF50'
'#8BC34A'
'#CDDC39'
'#FFEB3B'
'#FFC107'
'#FF9800'
'#FF5722'
'#795548']
All available Colors for the confetti pieces.
opacity Number 1.0
recycle Bool true Keep spawning confetti after numberOfPieces pieces have been shown.
run Bool true Run the animation loop
frameRate Number | undefined undefined The capped frame rate of the animation.
tweenDuration Number 5000 How fast the confetti is added
tweenFunction (currentTime: number, currentValue: number, targetValue: number, duration: number, s?: number) => number easeInOutQuad See tween-functions
drawShape (context: CanvasRenderingContext2D) => void undefined See below
onConfettiComplete (confetti: Confetti) => void undefined Called when all confetti has fallen off-canvas.

drawShape()

Draw a custom shape for a particle. If not provided, defaults to a random selection of a square, circle or strip confetto. The function is called with the canvas context as a parameter and the Particle as the this context.

For example, to draw all spirals:

<Confetti
  drawShape={ctx => {
    ctx.beginPath()
    for(let i = 0; i < 22; i++) {
      const angle = 0.35 * i
      const x = (0.2 + (1.5 * angle)) * Math.cos(angle)
      const y = (0.2 + (1.5 * angle)) * Math.sin(angle)
      ctx.lineTo(x, y)
    }
    ctx.stroke()
    ctx.closePath()
  }}
/>

changelog

6.4.0 (2025-03-04)

Bug Fixes

  • clamp tweenProgress between 0 and tweenDuration (f988305)

Features

  • adding tweenFrom property to allow smooth transition when parameters change (dde31e0)

6.3.0 (2025-03-01)

Bug Fixes

  • prevent particle flicker on removal (5cb5bd8)

Features

  • using elapsed time in physics updates (d1626dc)

6.2.3 (2025-02-22)

Bug Fixes

6.2.2 (2024-12-28)

Bug Fixes

6.2.1 (2024-12-27)

Bug Fixes

  • specify commonjs module (aa99153)

6.2.0 (2024-12-27)

Features

  • update peerDependencies to support React 19 (ce2d40a)
  • upgrade tooling (9c84a99)

6.1.0 (2022-05-20)

Bug Fixes

  • ci: add gh and npm tokens (ecc2d87)
  • ci: explicitly add npm token (fb14930)
  • Allow react 18 in peer dependency (6598781)

Features

  • ci: travis => gh actions (7af7f03)

6.0.1 (2021-02-22)

Bug Fixes

  • Allow react 17 in peer dependency (266a3dd)

6.0.0 (2020-07-17)

chore

BREAKING CHANGES

  • deps: Requires node >= 10.18

5.1.0 (2020-06-17)

Features

  • initial velocity range options\ (929bc50)

5.0.1 (2019-10-18)

Bug Fixes

  • use componentDidUpdate instead (1ad95f9), closes #73
  • types: make canvasRef optional (607068a), closes #72

5.0.0 (2019-10-18)

  • Merge pull request #70 from wheeler/mw-r169 (8e7ec50), closes #70

Bug Fixes

BREAKING CHANGES

  • Requires at least React version 16.3 - that version adds the new lifecycle method used to replace the unsafe one.

4.0.1 (2019-08-09)

Bug Fixes

  • types: remove NamedExoticComponent (b6dec94), closes #65

4.0.0 (2019-08-06)

Bug Fixes

  • disable pointer events again (a28a426), closes #63
  • Export the same class as the default export (385f981)

BREAKING CHANGES

  • changes module exports

3.1.2 (2019-07-11)

Bug Fixes

3.1.1 (2019-07-05)

Bug Fixes

3.1.0 (2019-04-25)

Features

  • add initialVelocityX and initialVelocityY props (bfc2ff5)

3.0.0 (2019-04-25)

Features

  • forward ref to inner canvas (091b055)

BREAKING CHANGES

  • wrap default export in forwardRef

2.8.0 (2019-04-17)

Features

  • Add onConfettiComplete param (8af89f2)

2.7.3 (2019-04-03)

Bug Fixes

  • Performance: stop raf loop before unmounting (fc2b48f), closes #47

2.7.2 (2019-04-02)

Bug Fixes

  • Destroy confetti instance on unmount (6965e37), closes #47

2.7.1 (2019-04-02)

Bug Fixes

  • trigger release to fix typescript typings (817b7c0), closes #45

2.7.0 (2019-03-18)

Bug Fixes

  • point to entire types dir (3c3184c)

Features

2.6.1 (2019-03-13)

Bug Fixes

  • add rotation direction to fix jump visible when rendering asymetrical shapes (ca2b22b)

2.6.0 (2019-03-10)

Features

  • Add prop to draw custom confetti (992376b)

2.5.0 (2019-03-08)

Features

  • build: output and add types to package (1349e1d)
  • ParticleGenerator: Bulk particle addition (3c9e108)
  • use easing function for adding confetti (829a560)

2.4.1 (2019-02-28)

Bug Fixes

  • test: testing semantic-release (ef3dfa8)