README

Meme Tangyuan

A Flarum extension that adds a meme/sticker picker to the post composer. Ships with a curated library of 280+ expressive stickers, and supports per-user favorites and custom names.

Features

Meme picker button in the post composer toolbar
Search by filename / custom name
Per-user favorites (right-click an item to favorite)
Per-user custom display names (right-click → Set Custom Name)
Images served through a cached static path for fast delivery
Ships with 280+ webp stickers out of the box
BBCode [tangyuan-meme src="..."][/tangyuan-meme] rendered as an inline image in posts

Installation

composer require tangyuan/meme-tangyuan:"*"

Then enable the Meme Tangyuan extension in your Flarum admin panel.

Updating

composer update tangyuan/meme-tangyuan
php flarum cache:clear
php flarum migrate

Adding your own memes

Place additional .png, .jpg, .jpeg, .gif, or .webp files into the extension's meme/ directory:

vendor/tangyuan/meme-tangyuan/meme/

Then clear the Flarum cache:

php flarum cache:clear

Files are copied into public/assets/meme-cache/ on first request.

Usage

Start writing a post.
Click the sticker icon in the composer toolbar.
Click a meme to insert it into your post.
Right-click a meme to favorite it or set a custom display name (max 15 chars).
Switch to the Favorites tab to see only your starred memes.

Development

# JS build
cd js
npm install
npm run build     # production build
npm run dev       # watch mode

License

MIT