ramon/avocado

A modern, feature-rich Flarum theme with advanced search, real-time messaging, and comprehensive multi-language support. Built on the Avocado foundation with significant enhancements.

2.1.13-beta 2026-04-11 01:46 UTC

Requires

• flarum/core: ^2.0.0

MIT

• Sami Mazouz
• Ramon Guilherme

• theme
• flarum

README

Avocado

A modern, feature-rich Flarum theme featuring advanced search capabilities, real-time messaging integration, comprehensive multi-language support, hero banners, tag colors, social sharing, and more. Originally forked from Asirem by Afrux, now significantly enhanced with new features and improvements.

Features

• Hero Banner — Upload and position a custom banner image at the top of your forum (auto-scaled to 1400px, converted to WebP)
• Tag Colors — Discussion list items styled with tag colors and unread indicators
• Share Button — Native Web Share API on mobile; clipboard fallback on desktop
• Action Icons — Optional Font Awesome icons on Like and Reply buttons
• Tags Page — Custom tile and cloud view for the tags page
• V1 Search Bar — Toggle between the classic dropdown search and the default modal

Requirements

• Flarum ^2.0.0

Installation

composer require ramon/avocado

Updating

composer update ramon/avocado --with-dependencies
php flarum cache:clear

Configuration

All settings are available in the admin panel under the Avocado extension:

Setting	Description	Default
Hero Image	Upload a banner image for the forum header	—
Hero Image Position	CSS background-position value	center top
V1 Search Bar	Use classic dropdown search instead of modal	true
Show Share Button	Display share button on posts	true
Show Action Icons	Show icons on Like and Reply buttons	true
Fixed Avatar Effect	Keep comment avatars sticky while reading posts on desktop	true

API Endpoints

Method	Endpoint	Description
POST	/api/avocado/banner	Upload hero banner image
DELETE	/api/avocado/banner	Remove hero banner image

Links

• GitHub
• Issues
• Discuss
• Donate

Authors

• Ramon Guilherme
• Sami Mazouz — original Asirem theme

License

MIT