Building an open-source Flutter client for Flarum (StarForum)

Open-source forums are great — but the client experience often isn't.

A while ago, a friend of mine deployed a forum using Flarum and wanted a dedicated mobile client for it. Our first attempt was simple: wrapping the forum website inside a WebView.

It quickly became clear that a native client would provide a much better experience.
So I started building one.That’s how StarForum began.

What is StarForum

StarForum is an open-source Flarum client built with Flutter.
The goal of the project is straightforward: Provide a fast, modern, and extensible client for Flarum forums.

Repository：cubevlmu/StarForum

Unlike many forum applications that are tied to a single community, StarForum is designed to be generic and reusable. Any Flarum instance can be connected, making it useful for multiple communities instead of just one.

Why Flutter
Flutter turned out to be a very good fit for this type of project.

1. Cross-platform development Flutter allows the same codebase to run on multiple platforms:

• Android
• iOS
• Windows
• macOS
• Linux

For an open-source project maintained by a small team (or even a single developer), this significantly reduces maintenance effort.

1. Smooth UI performance

Forum applications typically contain a lot of dynamic content:

• discussion lists
• nested replies
• notification feeds
• user profiles

Flutter’s rendering system makes it easier to maintain smooth scrolling and responsive interactions, even with complex UI layouts.

1. Flexible UI design

I didn’t want to simply replicate the web interface.
Instead, the goal was to design a mobile-first experience with a modern UI. Flutter makes it easy to implement:

• adaptive layouts
• animated transitions
• responsive components
• platform-friendly interactions

Current features
The project is still under active development, but several core pieces are already implemented.

• Forum browsing

Users can browse discussions and open discussion pages with rendered post content.

• User features

Basic account functionality is already working, including login, user profile pages, and avatar support.

• UI improvements

The interface follows a Material 3 style design, with responsive layouts that adapt to different screen sizes. Larger screens can use a split-view layout for better navigation.

• Performance considerations

Some optimizations are already in place, including caching strategies, optimized list rendering, and reduced widget rebuild overhead.

Project design goals
Several principles guide the architecture of the project.

1. Clean architecture The project separates different responsibilities into clear layers:
2. API layer
3. repository layer
4. UI layer

5. state management
   This structure helps keep the codebase maintainable and easier for new contributors to understand.

6. Modular components

Many parts of the UI are designed as reusable modules, such as:

• discussion widgets
• user components
• settings modules

This modular design allows new features to be added without introducing unnecessary complexity.

1. Extensibility

Since Flarum itself is highly extensible through plugins, the client should also remain flexible enough to support additional features in the future.

Why open source

Originally this was just a small personal project created for a single forum.
However, as the architecture became more general and reusable, open-sourcing the project felt like the natural next step.

By making StarForum open source:

• other Flarum communities can use it
• developers can experiment with new ideas
• contributors can help improve the client together

Looking for contributors
The project is still evolving, and contributors are very welcome.
There are many areas where help would be valuable.

• UI and UX improvements

polishing layouts
improving animations
accessibility improvements

• Feature development

notification system
richer post editor support
compatibility with Flarum plugins

• Performance optimization

smarter caching strategies
API request handling
large list rendering

• Platform support

improving desktop experience
deeper platform integrations

Even small contributions — bug fixes, documentation improvements, or issue reports — can help move the project forward.

How to get involved

If the project sounds interesting to you, feel free to join in.
You can:

⭐ Star the repository
🐛 Report issues
🔧 Submit pull requests
💬 Participate in discussions

Repository: cubevlmu/StarForum

Final thoughts
Open-source projects grow through collaboration.
StarForum is still at an early stage, but the goal is to build a high-quality open-source client for the Flarum ecosystem.

If you're interested in the idea or want to contribute, you're very welcome to join the project.

Thanks for reading ❤️