Open Web UI App 📱

⚠️ BETA WARNING: This project is currently in beta stage and is not yet complete. Features may be incomplete, unstable, or subject to breaking changes. Use at your own discretion and expect bugs!

A Flutter mobile application for Open WebUI, bringing AI chat capabilities to your mobile device with a native, smooth experience.

🚀 Features

• 💬 Native mobile chat interface
• 🔐 Secure authentication
• 📱 Cross-platform support (iOS, Android, Web, macOS, Linux, Windows)
• 🎨 Modern Material Design UI
• 🔄 Real-time messaging
• 📂 Chat session management

🛠️ Getting Started

Prerequisites

• Flutter (SDK 3.9.0 or higher)
• Dart
• For iOS development: Xcode
• For Android development: Android Studio/SDK

Installation

1. Clone the repository

   git clone https://github.com/your-username/open-webui-flutter.git
   cd open-webui-flutter

2. Navigate to the source directory

   cd src

3. Install dependencies

   flutter pub get

4. Run the app

   # For development
   flutter run
   
   # For specific platform
   flutter run -d chrome      # Web
   flutter run -d ios         # iOS Simulator
   flutter run -d android     # Android Emulator

Building for Production

# Android APK
flutter build apk --release

# iOS (requires Mac)
flutter build ios --release

# Web
flutter build web --release

# Desktop (macOS)
flutter build macos --release

# Desktop (Linux)
flutter build linux --release

# Desktop (Windows)
flutter build windows --release

📖 Development

Project Structure

src/
├── lib/
│   ├── api/          # API clients and endpoints
│   ├── models/       # Data models
│   ├── screens/      # UI screens
│   ├── services/     # Business logic services
│   ├── utils/        # Utility functions
│   └── widgets/      # Reusable UI components
├── android/          # Android-specific code
├── ios/              # iOS-specific code
├── web/              # Web-specific code
└── test/            # Unit and widget tests

Running Tests

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

Code Generation

# Generate JSON serialization code
flutter packages pub run build_runner build

🤝 Contributing

We welcome contributions from everyone! This is an open-source project and we'd love your help to make it better.

How to Contribute

1. 🍴 Fork the repository
2. 🌿 Create a feature branch

   git checkout -b feature/amazing-feature

3. 📝 Make your changes
4. ✅ Write/update tests if needed
5. 🧪 Run tests and ensure they pass

   flutter test
   flutter analyze

6. 📤 Commit and push your changes

   git commit -m "Add amazing feature"
   git push origin feature/amazing-feature

7. 🔄 Open a Pull Request

What We're Looking For

• 🐛 Bug fixes
• ✨ New features
• 📚 Documentation improvements
• 🎨 UI/UX enhancements
• 🧪 Test coverage improvements
• 🌐 Internationalization/localization
• ♿ Accessibility improvements

Development Guidelines

• Follow Flutter's style guide
• Write meaningful commit messages
• Add tests for new features
• Update documentation when needed
• Keep PRs focused and atomic

Getting Help

• 💬 Join our Discord (coming soon)
• 🐛 Report bugs via GitHub Issues
• 💡 Suggest features via GitHub Discussions

📱 Platform Support

Platform	Status	Notes
🤖 Android	✅ Working	API 21+
🍎 iOS	✅ Working	iOS 12+
🌐 Web	✅ Working	Modern browsers
🖥️ macOS	⚠️ Beta	macOS 10.14+
🐧 Linux	⚠️ Beta	Ubuntu 18.04+
🪟 Windows	⚠️ Beta	Windows 10+

🛣️ Roadmap

• Offline support
• Push notifications
• File upload/download
• Voice messages
• Dark/Light theme toggle
• Multiple server support
• Biometric authentication
• Chat backup/restore

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Thanks to the Open WebUI team for the amazing backend
• Flutter team for the excellent cross-platform framework
• All contributors who help make this project better

---

🌟 Example

Below is an example of the app's capabilities, showcasing its ability to provide detailed responses to user queries:

It sounds like you might be talking about a "Captain" from the Marvel universe! There are a couple of prominent ones:

1. Captain America
2. Captain Marvel

Could you specify which one you're interested in?

In the meantime, here's information for both:

If you mean Captain America:

Steve Rogers (original Captain America): His last major movie appearance was:

• Avengers: Endgame (2019)
  • This film concluded his story arc.

Sam Wilson (current Captain America): The character of Sam Wilson (formerly Falcon) officially took on the mantle of Captain America in the Disney+ series The Falcon and The Winter Soldier (2021). His next movie will be:

• Captain America: Brave New World (expected 2025)
  • This will be the first solo Captain America movie starring Sam Wilson.

---

⭐ Star this repo if you find it useful!

🐛 Found a bug? Report it here

💡 Have an idea? Share it with us