@nice2dev/events

Event & party system components for React applications — chat, rounds, music, attractions, planning, and content controls.

Installation

npm install @nice2dev/events

Peer dependencies: react >= 17.0.0, react-dom >= 17.0.0

Components

| Component | Category | Description | |---|---|---| | NiceEventChat | Party | Real-time event chat with reactions and message types | | NiceEventParticipants | Party | Participant list with roles, status, and QR codes | | NiceEventMedia | Content | Media gallery with upload, photos, and collages | | NiceEventPlanning | Planning | Event planning with dates, location, surveys, billing | | NiceRoundList | Rounds | Round system list with status and scoring | | NiceRoundCard | Rounds | Individual round card with actions, timer, scoreboard | | NiceSongPicker | Music | Song selection for music events | | NiceKaraokePicker | Music | Karaoke song picker with queue management | | NiceAttractionPicker | Attractions | Attraction selection grid with categories | | NiceAttractionVoting | Attractions | Anonymous voting on attractions |

Types & Interfaces

• EventModel — Core event data model
• EventParticipant — Participant with role and status
• EventRound — Round definition with scoring
• EventAttraction — Attraction with voting
• EventService — Abstract API interface for backend integration
• ChatMessage, SongEntry, KaraokeSong, BillingItem, EventSurvey, EventMediaItem

Usage

import { NiceEventChat, NiceEventPlanning, NiceRoundList } from '@nice2dev/events';

function EventPage({ event }) {
  return (
    <>
      <NiceEventPlanning event={event} />
      <NiceRoundList rounds={event.rounds} />
      <NiceEventChat eventId={event.id} />
    </>
  );
}

License

MIT © NiceToDev