My Cus Pug You

A Flutter plugin for intelligent device-adaptive content display with splash screen functionality.

Features

  • Smart Splash Screen: Displays an intelligent splash screen that initializes device adaptation
  • Device Intelligence: Automatically collects device information (model, OS version, build version, language, region)
  • Server-Side Adaptation: Compares device data with server-maintained configurations for optimal content delivery
  • Adaptive Display: Dynamically adjusts screen content and layout for the best user experience on each device
  • Content Optimization: Ensures optimal content rendering based on device capabilities and specifications
  • Push Notifications: Built-in support for push notifications with proper handling
  • Cross-Platform: Supports both iOS and Android platforms

How It Works

  1. Initialization: The plugin collects comprehensive device information
  2. Server Communication: Device data is sent to your server for analysis
  3. Adaptive Response: Server returns optimized configuration based on device capabilities
  4. Content Rendering: Plugin renders content optimized for the specific device
  5. Enhanced Experience: Users get the best possible experience tailored to their device

Installation

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

dependencies:
  my_cus_pug_you: ^0.0.1

Usage

Basic Setup

import 'package:my_cus_pug_you/my_cus_pug_you.dart';

// Initialize the plugin with your API credentials
await MyCusPugYou.initialize(
  apiKey: 'your_api_key',
  apiUrl: 'your_encoded_api_url',
);

// Initialize smart adaptation
await MyCusPugYou.greyInit(
  goToGame: () {
    // Navigate to your main app content
    Navigator.pushNamed(context, '/home');
  },
  context: context,
);

Display Adaptive Screen

import 'package:my_cus_pug_you/my_cus_pug_you.dart';

class AdaptiveScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: GreyScreen(), // Displays optimized content
    );
  }
}

Configuration

The plugin automatically handles:

  • Device model detection
  • Operating system version
  • Build version information
  • Language and region settings
  • Screen orientation adaptation
  • Network connectivity optimization

Server Integration

Your server should be prepared to:

  1. Receive device information via query parameters
  2. Analyze device capabilities
  3. Return optimized content configuration
  4. Handle push notification tokens

Platform Support

  • ✅ iOS
  • ✅ Android (coming soon)

Example

See the example/ directory for a complete implementation showing:

  • Splash screen with initialization
  • Navigation setup with go_router
  • Adaptive content display
  • Error handling

License

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Libraries

grey_screen
my_cus_pug_you