A Flutter client for WordPress sites that doesn't require authentication. Perfect for building mobile apps for WordPress-based blogs and news sites.
We've created a completely modernized version of this WordPress client with significant improvements:
📍 Switch to the modernized branch:
git checkout modernized-wordpress-client
Original (master) | Modernized (modernized-wordpress-client) |
---|---|
37 files, 4,487 lines | 15 files, ~1,500 lines |
16 dependencies | 8 core dependencies |
SQLite database | SharedPreferences caching |
Complex setup (30+ min) | Quick setup (2 minutes) |
Multiple providers | Unified provider |
Legacy patterns | Modern Flutter patterns |
- ✨ Material 3 Design - Clean, modern UI
- 🔍 Real-time Search - Instant search with infinite scroll
- 📱 Responsive Design - Perfect on all screen sizes
- 🌍 Arabic/Kurdish Support - Built-in font support
- ⚡ Performance Optimized - Faster loading and smoother scrolling
- 🧪 Fully Tested - Comprehensive test coverage
- 🚀 Production Ready - Environment-based configuration
🎯 Perfect for: Anyone who wants a simple, modern WordPress client without complexity.
- 📱 Clean, Material Design UI
- 🚀 Fast and responsive
- 📄 View posts and categories
- 🖼️ Media support
- 🔍 Search functionality
- 🌐 No authentication required
- Flutter SDK (>=3.2.0)
- Dart SDK (>=3.2.0)
- A WordPress site with REST API enabled
- Clone the repository:
git clone https://github.com/yourusername/Flutter-Wordpress-Client.git
- Install dependencies:
flutter pub get
-
Update the WordPress site URL in
lib/src/config.dart
-
Run the app:
flutter run
Edit lib/src/config.dart
to set your WordPress site URL and other configurations:
final String wordPressUrl = 'https://your-wordpress-site.com';
The app follows a clean architecture pattern:
/models
- Data models/widgets
- Reusable UI components/db
- Local database handling/view_models
- Business logic
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
for more information about WordPress rest API visit https://developer.wordpress.org/rest-api/For help getting started with Flutter, view Flutter online documentation.
I have used this repository: https://github.com/kbirch/wordpress_client
Flutter
Make sure your WordPress version is greater or equal to 4.7
Clone repository
git clone https://github.com/hooshyar/Flutter-Wordpress-Client.git
and open pubspec.yaml
run
flutter packages get
open config.dart and change "https://www.mihrabani.com"
to your website address for example if my website is wordpress.com you have to change it to this : "http://www.wordpress.com"
Do not add any additional characters like "/".
to your WordPress website address
run app on a simulator
flutter run
- Sliver app bar
- Sliver list view
- Connectivity status, if offline pop a message
- Cache on device
- Pull to refresh
- Global perPage
- Global theming
- Setting page
- Provider
- Splash screen
- Nice Categories page screen
- real time clap button like Medium
- Share and fav buttons
git clone https://github.com/hooshyar/Flutter-Wordpress-Client.git
cd Flutter-Wordpress-Client
git checkout modernized-wordpress-client
Setup time: ~2 minutes | Best for: New projects, production apps
git clone https://github.com/hooshyar/Flutter-Wordpress-Client.git
cd Flutter-Wordpress-Client
# Stay on master branch
Setup time: ~30 minutes | Best for: Learning, customization, legacy support
Feature | Master Branch | Modernized Branch |
---|---|---|
Architecture | Complex, 37 files | Simple, 15 files |
Dependencies | 16 packages | 8 packages |
Database | SQLite | SharedPreferences |
State Management | 3 separate providers | 1 unified provider |
UI Design | Custom Material | Material 3 |
Setup Complexity | High | Low |
Maintenance | High | Low |
Performance | Good | Optimized |
Testing | Basic | Comprehensive |
Documentation | Basic | Detailed |
💡 Recommendation: Use the modernized branch for new projects. It's production-ready, well-tested, and much easier to customize.