flutter_unify 1.0.0

Unified API layer for Flutter apps across Mobile, Web, and Desktop. Smart bundling, SEO optimization, and native integration.

flutter_unify

One unified layer for Flutter apps across Mobile, Web, and Desktop — smaller, faster, more native.

Flutter Unify provides a comprehensive unified API that adapts to your platform, offering native-grade performance and capabilities across all Flutter environments. With smart bundling, SEO optimization, desktop integration, and cross-platform system services, Flutter Unify makes it easy to build truly universal Flutter applications.

🚀 Features

🔹 Web Enhancements

Smart Bundling & Compression

• Advanced tree-shaking & compression strategies (leveraging esbuild/rollup under the hood)
• Splits core Flutter engine from app logic → only downloads once, cached separately
• Intelligent code splitting for optimal loading performance

SEO-friendly Rendering Layer

• Hybrid rendering: Canvas for UI but also exports semantic HTML "ghost DOM" for crawlers
• Works like a built-in version of seo_renderer, but official and maintained
• Automatic meta tag generation and structured data support

Progressive Loading (Lite Mode)

• Ships a lightweight HTML/JS "skeleton" that loads instantly on low-bandwidth
• Flutter app hydrates later for full functionality
• Think of it like Next.js SSR → but for Flutter

Cross-browser Polyfills

• Provides stable wrappers for APIs (FileSystem, Bluetooth, WebRTC) with graceful fallbacks
• Consistent behavior across all modern browsers

🔹 Desktop Enhancements

Unified System Menus & Tray API

• One API → maps to macOS menu bar, Windows system tray, Linux DBus indicators
• Global shortcuts supported out of the box
• Context menus with native look and feel

Native Drag & Drop

• First-class drag-drop API (text, files, URLs) that works consistently across macOS/Win/Linux
• Custom drag indicators and drop zones
• Multi-selection support

Window & Multi-monitor Manager

• Advanced window snapping, tiling, multi-window support
• Auto-detects OS capabilities (Aero Snap on Windows, Mission Control on macOS)
• Per-monitor DPI awareness

System Services Bridge

• Clipboard, notifications, file dialogs, screen capture → exposed via one stable API
• No need to import 5+ separate packages
• Native system integration without complexity

📦 Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_unify: ^0.1.0

Then run:

flutter pub get

🎯 Quick Start

Basic Setup

import 'package:flutter_unify/flutter_unify.dart';

void main() async {
  // Initialize Flutter Unify
  await Unify.initialize();
  
  runApp(MyApp());
}

Cross-Platform System Operations

import 'package:flutter_unify/flutter_unify.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return UnifiedScaffold(
      body: ElevatedButton(
        onPressed: () async {
          // Works on all platforms
          await Unify.system.clipboardWriteText('Hello World!');
          await Unify.system.showNotification(
            title: 'Success',
            body: 'Text copied to clipboard!',
          );
        },
        child: Text('Copy to Clipboard'),
      ),
    );
  }
}

Platform-Specific Features

class PlatformSpecificFeatures extends StatefulWidget {
  @override
  _PlatformSpecificFeaturesState createState() => _PlatformSpecificFeaturesState();
}

class _PlatformSpecificFeaturesState extends State<PlatformSpecificFeatures> {
  @override
  void initState() {
    super.initState();
    _setupPlatformFeatures();
  }
  
  void _setupPlatformFeatures() async {
    // Web-specific optimizations
    if (PlatformDetector.isWeb) {
      Unify.web.seo.setPageTitle('My Flutter App');
      Unify.web.seo.setPageDescription('A unified Flutter experience');
      await Unify.web.progressiveLoader.initialize();
    }
    
    // Desktop integration
    if (PlatformDetector.isDesktop) {
      await Unify.desktop.systemTray.create(
        icon: 'assets/tray_icon.png',
        tooltip: 'My Flutter App',
      );
      
      await Unify.desktop.shortcuts.register(
        'Ctrl+Shift+A',
        () => print('Global shortcut activated!'),
      );
    }
    
    // Mobile features
    if (PlatformDetector.isMobile) {
      final deviceInfo = await Unify.mobile.deviceInfo.getDeviceInfo();
      print('Running on: ${deviceInfo.model}');
    }
  }
  
  @override
  Widget build(BuildContext context) {
    return UnifiedScaffold(
      enableDragAndDrop: true,
      onFilesDropped: (files) => print('Files dropped: ${files.length}'),
      body: PlatformAdaptiveWidget(
        mobile: Text('Mobile UI'),
        web: Text('Web UI'),
        desktop: Text('Desktop UI'),
        fallback: Text('Universal UI'),
      ),
    );
  }
}

📚 Documentation

• Web Optimizations Guide
• Desktop Integration Guide
• API Reference
• Examples

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

📄 License

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

🔗 Related Packages

• window_manager - Window management (complementary)
• system_tray - System tray integration (alternative)
• seo_renderer - SEO rendering (alternative)

🆘 Support

• GitHub Issues
• Flutter Community Discord
• Stack Overflow

FLUTTER_UNIFY