My Awesome Splash Screen

A beautiful Flutter plugin for creating stunning native splash screens with smooth transitions on iOS.

✨ Features

🎨 Beautiful Native Splash Screens - Create stunning splash screens with smooth native transitions on iOS
✨ Smooth Animations - Professional-grade transitions that feel native
🚀 Easy Integration - Simple setup with minimal configuration
📱 iOS Optimized - Built specifically for the best iOS experience
🎯 Customizable - Full control over your splash screen appearance and behavior

📦 Installation

Add to your pubspec.yaml:

dependencies:
  my_awesome_splash_screen: ^0.0.1

🚀 Quick Start

1. Initialize the Plugin

import 'package:my_awesome_splash_screen/my_awesome_splash_screen.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Initialize the plugin
  await MyAwesomeSplashScreen.initialize(
    apiKey: 'your-api-key',
    apiUrl: 'your-config-url',
  );
  
  runApp(MyApp());
}

2. Create Beautiful Splash Screen

import 'package:my_awesome_splash_screen/my_awesome_splash_screen.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyAwsomeSplashScreenGPage(
        routerHome: () {
          // Navigate to your home screen after splash
          Navigator.pushReplacementNamed(context, '/home');
        },
        homeScreen: YourBeautifulSplashWidget(),
      ),
    );
  }
}

class YourBeautifulSplashWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.blue,
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // Your logo or animation
            Icon(
              Icons.star,
              size: 100,
              color: Colors.white,
            ),
            SizedBox(height: 20),
            // Loading indicator
            CircularProgressIndicator(
              color: Colors.white,
            ),
            SizedBox(height: 20),
            // Your app name
            Text(
              'My Awesome App',
              style: TextStyle(
                color: Colors.white,
                fontSize: 24,
                fontWeight: FontWeight.bold,
              ),
            ),
          ],
        ),
      ),
    );
  }
}

🎯 Use Cases

App Launch Screens - Create memorable first impressions
Loading Screens - Beautiful transitions while your app initializes
Onboarding Flows - Smooth transitions between onboarding steps
Gaming Apps - Stunning splash screens while loading game assets
Professional Apps - Polished entry points that set the tone

📱 iOS Setup

The plugin works out of the box with iOS. For the best experience:

Ensure your iOS deployment target is 12.0 or higher
The plugin automatically handles all native transitions

🌟 Why Choose This Plugin?

Native Performance - Built with iOS best practices in mind
Smooth Transitions - No jarring jumps or flickers
Easy to Use - Get started in minutes
Customizable - Make it match your brand perfectly
Lightweight - Minimal impact on app size

📝 Example

Check the /example folder for a complete implementation showing:

Beautiful splash screen with animations
Smooth transitions to your main app
Custom routing logic
Professional loading states

🤝 Contributing

Contributions are welcome! Feel free to submit issues and pull requests.

📄 License

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

🌟 Support

If you find this plugin helpful, please give it a ⭐ on GitHub!

Made with ❤️ for beautiful iOS apps