@umkatakam/init-sequence

A festive cross-platform Node.js CLI tool that displays spectacular terminal fireworks followed by a celebratory New Year message!

Features

• Cross-platform support (macOS, Linux, Windows)
• Beautiful terminal fireworks display (~5 seconds)
• ASCII art New Year message with personalization
• Optional --to parameter for personalized greetings
• Zero dependencies (uses npx for fireworks)
• ESM-based modern Node.js package

Installation

Via npx (Recommended)

No installation needed! Just run:

npx @umkatakam/init-sequence

Global Installation

npm install -g @umkatakam/init-sequence
init-sequence

Usage

Basic Usage

npx @umkatakam/init-sequence

This will:

1. Launch terminal fireworks for ~5 seconds
2. Display an ASCII art "Happy New Year 2026!" message

Personalized Greeting

npx @umkatakam/init-sequence --to=Alice

Output: Happy New Year 2026, Alice!

npx @umkatakam/init-sequence --to="John Doe"

Output: Happy New Year 2026, John Doe!

Requirements

• Node.js >= 14.0.0
• Internet connection (for npx to download firew0rks package)

Windows Compatibility

This package is fully compatible with Windows:

• Automatically uses npm.cmd on Windows for proper command execution
• Cross-platform process termination - handles Windows and Unix signals correctly
• Color support detection - automatically enables/disables colors based on terminal capabilities
  • ✅ Windows Terminal (recommended)
  • ✅ PowerShell 7+
  • ✅ VS Code integrated terminal
  • ✅ Windows 10+ Command Prompt
  • ⚠️ Older Windows systems will display without colors (graceful fallback)

How It Works

The CLI tool:

1. Uses npm exec to run the firew0rks package (installed on-the-fly)
2. Automatically stops the fireworks after ~5 seconds
3. Handles platform differences (uses npm.cmd on Windows)
4. Displays an ASCII art festive New Year greeting

Development

Local Testing

# Clone the repository
git clone https://github.com/umkatakam/init-sequence.git
cd init-sequence

# Make the script executable (Unix-like systems)
chmod +x bin/init-sequence.mjs

# Test locally
node bin/init-sequence.mjs

# Or test with npm link
npm link
init-sequence

Publishing

# Login to npm (if not already logged in)
npm login

# Publish the package
npm publish --access public

License

MIT License - see LICENSE file for details

Author

Mahesh Katakam

Contributing

Issues and pull requests are welcome!