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(),
      ),
    );
  }
}

🎨 Creating Your Splash Screen Widget #

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:

1. Ensure your iOS deployment target is 12.0 or higher
2. 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