npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

gopromotional-event-planner

v1.0.1

Published

Event countdown, planning timeline, giveaway quantities and print order-by dates.

Readme

gopromotional-event-planner

Plan an event or trade show from the command line or your code: a countdown, a 12-step planning timeline with due dates, an estimate of how many giveaway items to order, and the latest order date for printed merchandise in working days.

  • Countdown to the event in days, and in weeks + days.
  • Planning timeline: 12 tasks from 8 weeks out to the post-event follow-up, each with a due date, days left and an overdue flag.
  • Giveaway quantity: attendees × days × uptake × items per person, plus a buffer, rounded up.
  • Order-by date: production + delivery + safety margin counted back in working days (Mon–Fri).

Install

npm install gopromotional-event-planner          # library
npm install -g gopromotional-event-planner       # CLI
npx gopromotional-event-planner --help

Command line

$ gopromotional-event-planner countdown 2026-12-03 --today 2026-10-19
45 days to go (6 weeks 3 days) until 2026-12-03.

$ gopromotional-event-planner giveaways --attendees 500 --days 2 --uptake 0.6
Order 660 items (600 expected + 60 buffer).

$ gopromotional-event-planner order-by 2026-12-03 --today 2026-10-19
Order by 2026-11-12 (15 working days before the event), 24 days from today.

$ gopromotional-event-planner timeline 2026-12-03 --today 2026-10-19
! 2026-10-08  Confirm budget and attendee estimate  (overdue)
! 2026-10-15  Book the venue  (overdue)
  2026-10-22  Order branded merchandise and giveaways
  2026-10-29  Send invitations or open registration
  2026-11-05  Confirm speakers and agenda
...

Every command accepts --json for machine-readable output. Run gopromotional-event-planner --help for all options.

Library

const { countdown, giveawayQuantity, orderByDate, timeline } = require('gopromotional-event-planner');

countdown('2026-12-03', '2026-10-19');               // { days: 45, weeks: 6, remainderDays: 3, status: 'upcoming', ... }
giveawayQuantity({ attendees: 500, days: 2 });         // { base: 600, buffer: 60, total: 660 }
orderByDate('2026-12-03', { today: '2026-10-19' });    // { orderBy: '2026-11-12', workingDays: 15, daysFromToday: 24, late: false }
timeline('2026-12-03', { today: '2026-10-19' })[0];    // { task: 'Confirm budget and attendee estimate', due: '2026-10-08', overdue: true, ... }

The library is a single dependency-free UMD file: it also works in the browser as a <script> tag (see the Hugging Face Space for a live demo).

Links