Quick Start

The Celebrations system automatically detects the current date and activates the appropriate theme during celebration periods. Simply include the layout system in your page:

<!-- Include Domma -->
<script src="dist/domma.min.js"></script>

<!-- Include Layout System (handles celebrations automatically) -->
<script type="module" src="layouts/js/layout.js"></script>

Manual Control

For testing or manual control, you can enable celebrations with specific settings:

// Import the celebrations module
import CelebrationsEffect from './layouts/js/modules/celebrations/index.js';

// Create instance with options
const celebrations = new CelebrationsEffect({
  theme: 'christmas',     // or 'auto' for date detection
  intensity: 'medium',    // 'light', 'medium', or 'heavy'
  enabled: true,
  container: document.body
});

// Start the effect
celebrations.start();

// Change theme dynamically
await celebrations.setTheme('halloween');

// Change intensity
celebrations.setIntensity('heavy');

// Pause/resume
celebrations.pause();
celebrations.start();

// Cleanup
celebrations.destroy();

Available Themes

• christmas - Snowflakes, Santa's sleigh, reindeer, trees, wreaths, robins, toy trains, elves (Dec 1 - Jan 1)
• halloween - Pumpkins, bats, ghosts, witches, gravestones, spiders (Oct 26-31)
• valentines - Hearts, rose petals, cupid, love letters (Feb 9-14)
• guy-fawkes - Fireworks, bonfires, rockets, catherine wheels, roman candles (Nov 1-5)
• st-patricks - Shamrocks, gold coins, leprechauns, pots of gold, rainbows (Mar 12-17)
• st-andrews - Thistles, Scottish flag, bagpiper, heather (Nov 25-30)
• st-davids - Daffodils, leeks, Welsh dragon, flags (Feb 24 - Mar 1)
• st-georges - Rose petals, knights, dragons, English flag (Apr 18-23)

Intensity Levels

• light - Fewer particles, subtle effects, better performance
• medium - Balanced particle count, recommended default
• heavy - Maximum particles and decorations, spectacular display

Automatic Detection

When theme is set to 'auto', the system automatically:

• Detects the current date
• Checks if any celebration is active
• Activates the appropriate theme
• Returns null if no celebration is currently active