# 😈 unmotivator

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

## Installation

```unmotivator/README.md#L1-6
# 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.

```unmotivator/README.md#L1-16
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:

```unmotivator/README.md#L17-32
// 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](https://github.com/grenish)

---

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