@meebs/meeb 1.0.1 → 1.0.3

package/README.md

@@ -1,19 +1,28 @@
-# meeb
+<div align="center">
 
-```
-    ▐▛███▜▌
-   ▐█▄███▄█▌        72 hand-drawn ASCII animals
-   ▐███▄███▌        for your terminal.
-    ▝▀███▀▘
-   ▗▄▛███▜▄▖        zero dependencies.
-   ▐███████▌        pure joy.
-   ▐███████▌
-    ▝█████▘
-     ▟█▙ ▟█▙
-     ▀▀▀ ▀▀▀
-```
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/logo.png" alt="meeb" width="200">
+
+**72 hand-drawn ASCII animals for your terminal.**
+
+zero dependencies. pure joy.
+
+[![npm](https://img.shields.io/npm/v/@meebs/meeb?color=d7775b&label=npm)](https://www.npmjs.com/package/@meebs/meeb)
+[![license](https://img.shields.io/badge/license-CC%20BY--NC%204.0-blue)](https://creativecommons.org/licenses/by-nc/4.0/)
+[![node](https://img.shields.io/badge/node-%3E%3D14-green)](https://nodejs.org)
+[![size](https://img.shields.io/badge/size-39kb-orange)](https://www.npmjs.com/package/@meebs/meeb)
+
+<br>
 
-A passion project to bring a little good into the world. Because every terminal deserves a friend.
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/fox-white.png" alt="fox" width="80">
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/penguin-white.png" alt="penguin" width="80">
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/snail-white.png" alt="snail" width="80">
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/dragon-white.png" alt="dragon" width="80">
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/owl-white.png" alt="owl" width="80">
+<img src="https://unpkg.com/@meebs/meeb@latest/assets/axolotl-white.png" alt="axolotl" width="80">
+
+</div>
+
+---
 
 ## Install
 
@@ -21,7 +30,7 @@ A passion project to bring a little good into the world. Because every terminal
 npm install -g @meebs/meeb
 ```
 
-## Quick Start
+## Try It
 
 ```bash
 meeb fox                 # show a fox
@@ -30,129 +39,111 @@ meeb cat hat             # seasonal hat (changes every month!)
 meeb random              # surprise me
 meeb 🐧                  # emoji lookup
 echo "hello" | meeb dog  # pipe stdin as speech
-meeb --motd              # add to your .bashrc for daily joy
 ```
 
-## Animals
+## 72 Animals
 
-```
-  ▄▖       ▗▄          ▄██▖       ▗██▄
-  ██▖     ▗██          ████▖     ▗████
-  ▐██▄▄▄██▌            ▝███████████▘
-  ▐█◆█▄█◆█▌              ▐█●███●█▌         ...and 70 more
-  ▐███▄███▌              ▐██▄▄▄██▌
-   ▝▀███▀▘               ▐██▀▀▀██▌
-   ▐█████▌               ▐███████▌
-   ▐███████▌              ▟█▘ ▝█▙
-    ▟▘ ▝▙                 ▀▀▀ ▀▀▀
-      fox                    dog
-```
+<details>
+<summary><strong>See all 72 →</strong></summary>
+<br>
 
-penguin, cat, dog, fox, bear, owl, bunny, frog, panda, snake, duck, mouse, whale, octopus, bat, fish, turtle, crab, monkey, pig, koala, lion, shark, elephant, unicorn, jellyfish, sloth, wolf, parrot, hedgehog, giraffe, flamingo, raccoon, hippo, deer, squid, gorilla, dragon, alien, robot, ghost, dino, zebra, snail, bee, butterfly, scorpion, emperor, crocodile, chameleon, seahorse, stingray, axolotl, capybara, redpanda, peacock, spider, chick, ladybug, otter, mantisshrimp, narwhal, moth, cookie, hamster, swan, eagle, walrus, toucan, yak, firefly, starfish
+penguin · cat · dog · fox · bear · owl · bunny · frog · panda · snake · duck · mouse · whale · octopus · bat · fish · turtle · crab · monkey · pig · koala · lion · shark · elephant · unicorn · jellyfish · sloth · wolf · parrot · hedgehog · giraffe · flamingo · raccoon · hippo · deer · squid · gorilla · dragon · alien · robot · ghost · dino · zebra · snail · bee · butterfly · scorpion · emperor · crocodile · chameleon · seahorse · stingray · axolotl · capybara · redpanda · peacock · spider · chick · ladybug · otter · mantisshrimp · narwhal · moth · cookie · hamster · swan · eagle · walrus · toucan · yak · firefly · starfish
 
-## Say Things
+</details>
 
+## Animations
+
+Four terminal animations that make your animals come alive:
+
+```bash
+meeb penguin delay       # ✨ pixels materialize from nothing
+meeb penguin slide       # → slides in from the right
+meeb fox fall            # ↓ drops from the top with a bounce
+meeb snail shatter       # 💥 appears, then explodes with gravity
 ```
- __________
-< rawr     >
- ‾‾‾‾‾‾‾‾‾‾
-     |
-
-   ▄▖         ▗▄
-   ██▖       ▗██
-   ▐█████████████▌
-    ▝█◆█████████◆█▘
-    ▐████▀▄▀████▌
-     ▝▀█████████▀▘
-  ▄████████████████▄
-  ▝████▌██████▐████▘
-       ▟██▘ ▝██▙
-       ▀▀▀▀ ▀▀▀▀
-```
+
+**`shatter`** draws your animal, holds for a beat, then every character launches with random velocity and falls with real physics. It's wild. Try it.
+
+## Say Things
 
 ```bash
-meeb dragon say "rawr"
-meeb owl fortune              # random fortune cookie
-meeb penguin commit           # git commit message as speech
-echo "deploy complete" | meeb cat
+meeb dragon say "rawr"              # speech bubble
+meeb owl fortune                    # random fortune cookie
+meeb penguin commit                 # git commit message
+echo "deploy complete" | meeb cat   # pipe anything
 ```
 
 ## Seasonal Hats
 
-`meeb fox hat` gives your animal a hat that changes every month:
+`meeb fox hat` — a different hat every month:
 
-| Month | Hat |
-|-------|-----|
-| Jan/Dec | Santa hat |
-| Feb | Heart |
-| Mar | Shamrock |
-| Apr | Rain cloud |
-| May | Flower |
-| Jun | Sun |
-| Jul | Firework |
-| Aug | Sunglasses |
-| Sep | Falling leaf |
-| Oct | Jack-o-lantern |
-| Nov | Pilgrim hat |
+| | | | |
+|---|---|---|---|
+| 🎅 **Dec/Jan** Santa | ❤️ **Feb** Heart | ☘️ **Mar** Shamrock | 🌧️ **Apr** Rain |
+| 🌸 **May** Flower | ☀️ **Jun** Sun | 🎆 **Jul** Firework | 😎 **Aug** Shades |
+| 🍂 **Sep** Leaf | 🎃 **Oct** Pumpkin | 🦃 **Nov** Pilgrim | |
 
-## Features
+## Transforms
 
 ```bash
-# display
-meeb cat tiny                  # compact 4-row version
-meeb fox flip                  # mirror horizontally
-meeb panda --theme neon        # color themes: neon, pastel, retro, mono, matrix
-meeb bear --no-color           # strip ANSI codes
-meeb owl --label "wise bird"   # subtitle text below the animal
-
-# transforms
-meeb fox stretch               # stretch horizontally (wider)
-meeb fox squish                # squish horizontally (narrower)
-meeb fox stretchv              # stretch vertically (taller)
-meeb fox squishv               # squish vertically (shorter)
-
-# animations
-meeb penguin delay             # pixels materialize randomly
-meeb penguin slide             # slide in from the right
-meeb fox fall                  # drop from the top with a bounce
-meeb snail shatter             # appear, then explode with gravity
-
-# friends
-meeb cat pair dog              # two animals side by side
-meeb cat diff fox              # compare two animals
-meeb owl animate               # blinking animation
+meeb fox stretch         # wider
+meeb fox squish          # narrower
+meeb fox stretchv        # taller
+meeb fox squishv         # shorter
+meeb fox flip            # mirror horizontally
+```
 
-# facts
-meeb narwhal info              # fun animal fact
-meeb calendar                  # animal of the day
+## Export
 
-# browse
+```bash
+meeb fox --png                 # save as png
+meeb fox --gif                 # save as gif
+meeb fox --svg                 # save as svg
+meeb fox --png --white         # white background
+meeb fox --label "best fox"    # subtitle text below
+```
+
+## More
+
+```bash
+meeb cat pair dog              # two animals side by side
+meeb cat diff fox              # compare them
+meeb owl animate               # blinking animation
 meeb all                       # show every animal
 meeb browse                    # interactive TUI
-meeb list                      # names only (for scripting)
+meeb narwhal info              # fun animal fact
+meeb calendar                  # animal of the day
+meeb panda --theme neon        # neon, pastel, retro, mono, matrix
+meeb --install-completions     # bash, zsh, fish
+```
 
-# export
-meeb fox --gif                 # save as gif
-meeb fox --png                 # save as png
-meeb fox --svg                 # save as svg
-meeb fox --png --white         # white background export
+## Add to Your Shell
 
-# devtools
-meeb --motd                    # message of the day for .bashrc/.zshrc
-meeb --commit                  # git post-commit hook
-meeb --ci                      # markdown-safe output (no ANSI)
+```bash
+# ~/.bashrc or ~/.zshrc
+meeb --motd
 ```
 
-## Shell Completions
+A random animal greets you with a fortune every time you open a terminal.
+
+## Devtools
 
 ```bash
-meeb --install-completions     # bash, zsh, and fish
+meeb --motd              # message of the day for .bashrc/.zshrc
+meeb --commit            # git post-commit hook
+meeb --ci                # markdown-safe output (no ANSI)
 ```
 
 ## Zero Dependencies
 
-No `node_modules`. No bloat. Just Node.js 14+ and 72 animals.
+No `node_modules`. No bloat. Just Node.js and 72 animals in 39kb.
+
+---
+
+<div align="center">
+
+a passion project to bring a little good into the world.
 
-## License
+[CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) — free to use and share, not for commercial use.
 
-[CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) — free to use and share with attribution, not for commercial use.
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meebs/meeb",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Cute ASCII art animals for your terminal",
   "bin": {
     "meeb": "./index.js"
@@ -30,7 +30,8 @@
     "util.js",
     "info.js",
     "animals/",
-    "completions/"
+    "completions/",
+    "assets/"
   ],
   "engines": {
     "node": ">=14"