😈 unmotivator

A tiny library that returns random demotivational quotes — honest, blunt, and a little cruel.

Installation

# npm
npm install unmotivator

# bun
bun add unmotivator

# pnpm
pnpm add unmotivator

Usage

You can import the default export unmotivate (a function that returns a random quote from all categories) and the named exports Dev and Gen for category-specific quotes.

import unmotivate, { Dev, Gen } from "unmotivator";

// Default: random quote from all categories
const any = unmotivate();
console.log(any);

// Dev-specific quote (two equivalent ways)
const dev1 = Dev();
const dev2 = unmotivate.Dev(); // dot-notation convenience
console.log(dev1, dev2);

// General quote (two equivalent ways)
const gen1 = Gen();
const gen2 = unmotivate.Gen(); // dot-notation convenience
console.log(gen1, gen2);

If you need multiple quotes at once, there is no unmotivateMany exported by the package — simply call the function multiple times or build a small helper:

// Local helper to get multiple random quotes
function unmotivateMany(count) {
  return Array.from({ length: count }, () => unmotivate());
}

const three = unmotivateMany(3);
console.log(three);

API

• default export — unmotivate(): string
  Returns a random demotivational quote from all categories.

• named export — Dev(): string
  Returns a random dev-focused demotivational quote.

• named export — Gen(): string
  Returns a random general demotivational quote.

• convenience properties
  The default export also exposes the category helpers for dot-notation:

  • unmotivate.Dev() — same as the named Dev export
  • unmotivate.Gen() — same as the named Gen export

Notes:

• The package does not currently export helpers like getAllQuotes, getQuoteCount, or unmotivateMany. If you need those, implement simple helpers in your app (examples above).
• All functions return string.

Example Use Cases

• CI/CD: print a demotivational quote when a build fails
• Terminal startup: greet yourself with a dose of reality
• Chatbots: drop a quote into your team channel for maximum morale impact
• Error pages: replace comforting copy with brutal honesty

Contributing

PRs are welcome if you have more demotivational quotes to add. Please keep the tone consistent with the existing collection.

When contributing:

• Add quotes to the appropriate category (dev vs general).
• Keep quotes as plain strings (one sentence / short paragraph preferred).
• Follow repo contribution guidelines (tests/linting if present).

License

MIT © Grenish Rai

"You're not failing, you're just succeeding at being mediocre." - unmotivator