ramon/avocado

A modern, performance minded theme for Flarum 2

v2.0.36 2026-06-11 12:56 UTC

Requires

• flarum/core: ^2.0.0

Requires (Dev)

• flarum/tags: ^2.0.0
• mockery/mockery: ^1.6
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^11.5 || ^13.2.0

Suggests

• flarum/tags: Required for the showcase widget and tag-based hero images (^2.0).

MIT

• Sami Mazouz
• Ramon Guilherme

• theme
• flarum

README

Avocado

A modern theme for Flarum 2, grown out of Asirem.

Avocado started as a fork of the excellent Asirem by Afrux and kept walking from there. Today it is a full theme with its own search experience, hero banners, tag colored discussion lists and a pile of small touches that make a forum feel finished.

It is also the theme I run in production, so performance is treated as a feature: route based lazy loading, critical CSS inlined, async stylesheets and WebP conversion for banners.

What it does

• Hero banner with upload and positioning, auto scaled and converted to WebP
• Discussion list tinted with tag colors, including unread indicators
• Advanced search page plus an optional classic dropdown search bar
• Native share button, with the Web Share API on mobile and clipboard fallback
• Custom tags page with tile and cloud views
• Optional icons on Like and Reply buttons, sticky avatars while reading, and more

Installation

composer require ramon/avocado
php flarum cache:clear

Enable Avocado on the Extensions page. Every setting is in the admin panel with a description next to it.

Squeezing the most out of it

The theme does its part, but text compression and cache headers live on your web server. If Lighthouse complains about uncompressed text, follow the nginx and Apache recipes in docs/performance-host.md.

Credits

Original Asirem theme by Sami Mazouz. Avocado is maintained by Ramon Guilherme.

License

MIT. Ideas and bug reports are welcome on the issue tracker.