Step 1

Overview & System Requirements

๐ŸŽ‰ Welcome to MindFlow!

MindFlow is a premium AI-powered todo management app built specifically for CodeCanyon. This guide will take you through the complete setup process, from installation to publishing on app stores.

โœ… What you'll achieve:
  • Fully customized todo app with your branding
  • Ready-to-publish APK/AAB files
  • Professional app ready for app stores

๐Ÿ“‹ What You Need Before Starting

๐Ÿ’ป

Flutter SDK

Version 3.8.1 or higher

flutter --version
๐Ÿค–

Android Studio

Latest version with Android SDK

For Android app development

๐ŸŽ

Xcode (Optional)

Latest version (macOS only)

Only needed for iOS development

โฑ๏ธ

Time Required

30-60 minutes total

Depending on your customizations

๐ŸŽฏ What's Included

๐Ÿค–
AI-Powered Features

Smart suggestions, auto-categorization, priority intelligence

๐ŸŽจ
Modern Design

Glassmorphism effects, gradient themes, smooth animations

๐Ÿ”ง
Easy Customization

Change colors, app name, icon without touching code

๐Ÿ”
Secure & Compliant

Play Store ready, latest security standards

Step 2

Installation & Setup

โš ๏ธ Important: Make sure you have Flutter 3.8.1+ installed before proceeding. Check with flutter --version
1

Extract the Files

Extract the MindFlow package to your desired directory:

# Extract to your projects folder
unzip mindflow-source.zip
cd mindflow/
2

Install Dependencies

Install all required Flutter packages:

# Clean previous builds and get dependencies
flutter clean
flutter pub get
๐Ÿ’ก This will take a few minutes: Flutter needs to download all the required packages for the first time.
Flutter Pub Get

Flutter Pub Get

3

Generate Required Files

Generate model files and other required code:

# Generate model files and other required code
flutter packages pub run build_runner build --delete-conflicting-outputs
4

Test the Installation (Optional, only if you want to run the app in emulator)

Verify everything works by running the app:

# Run the app (make sure you have a device/emulator connected)
flutter run
โœ… Success! If you see the MindFlow app running, you're ready to proceed to customization!

๐Ÿ”ง Quick Troubleshooting

โŒ "Flutter not found":

Make sure Flutter is added to your system PATH. Run flutter doctor to check your setup.

โŒ Build fails:

Try running flutter doctor and fix any issues shown, then run flutter clean && flutter pub get

Step 3

Basic Customization

Let's start with the most basic customizations. All branding settings are centralized in one file for easy modification.

๐Ÿ“ Open the Branding File

Navigate to and open this file in your code editor:

lib/core/config/app_branding.dart
Branding file

App branding configuration file

โœ๏ธ Quick Test Customization

Let's make a quick change to see how easy it is:

โŒ Before (Default):

// Default values
static const String appName = 'MindFlow';
static const String appTagline = 'Smart Task Management';
static const String companyName = 'Zoon11';

โœ… After (Your Brand):

// Your customized values
static const String appName = 'MyTodoApp';
static const String appTagline = 'Get Things Done';
static const String companyName = 'Your Company';

๐Ÿงช Test Your Changes (Optional, only if you're running the emulator)

1

Save the file after making changes

2

Run the app to see your changes:

flutter hot restart
3

Check the app title and settings screen to see your new branding!

๐Ÿ’ก That's it for basic customization! You've just learned the foundation of customizing MindFlow. In the next steps, we'll dive deeper into app names, colors, and icons.
Step 4

Complete App Name & Branding

โš ๏ธ Important: Changing the app name requires updates in multiple files. Follow ALL steps below or your app may not work correctly.
1๏ธโƒฃ

Update App Branding (Already Done)

In lib/core/config/app_branding.dart:

static const String appName = 'YourAppName';
static const String appTagline = 'Your App Tagline';
static const String companyName = 'Your Company Name';
2๏ธโƒฃ

Update Package Configuration

Open pubspec.yaml and update:

# Change the package name and description
name: your_app_name
description: "Your App - Amazing Todo Management"
Pubspec.yaml File

Pubsex.yaml File Changes (Click Image to View)

3๏ธโƒฃ

Update Android Display Name (just Change the Label)

Open android/app/src/main/AndroidManifest.xml and change:

<application
    android:label="YourAppName"
    android:name="${applicationName}"
    android:icon="@mipmap/launcher_icon">
AndroidManifest.xml File

AndroidManifest.xml File Changes (Click Image to View)

4๏ธโƒฃ

Update iOS Display Name

Open ios/Runner/Info.plist and update:

<key>CFBundleDisplayName</key>
<string>YourAppName</string>
<key>CFBundleName</key>
<string>YourAppName</string>
5๏ธโƒฃ

Clean and Test (flutter run only if you're running the emulator)

After making all changes, clean and rebuild:

# Clean and rebuild to apply all changes
flutter clean
flutter pub get
flutter run
โœ… Perfect! Your app now has your custom name everywhere!

๐Ÿ”— Additional Branding Options

You can also customize these optional settings in the branding file:

Support Email: static const String supportEmail = 'support@yourapp.com';
Website URL: static const String websiteUrl = 'https://yourapp.com';
Privacy Policy: static const String privacyPolicyUrl = 'https://yourapp.com/privacy';
Step 5

Colors & App Icon Customization

๐ŸŽจ Customizing Colors

MindFlow uses a smart color system - you only need to set 3 main colors and the app automatically generates all variations!

Main Brand Colors

In lib/core/config/app_branding.dart, update these values:

// Primary brand color - main color of your app
static const Color primaryColor = Color(0xFF6366F1);

// Secondary brand color - accent color for highlights
static const Color secondaryColor = Color(0xFF8B5CF6);

// Accent color for special elements like AI features
static const Color accentColor = Color(0xFFF59E0B);
Branding File

Branding File Changes for Colors (Click Image to View)

๐ŸŽจ Ready-Made Color Schemes

Don't want to pick colors? Use one of these preset combinations:

๐Ÿ’™ Ocean Blue
primaryColor = Color(0xFF2563EB);
secondaryColor = Color(0xFF3B82F6);
accentColor = Color(0xFF06B6D4);
๐Ÿ’š Nature Green
primaryColor = Color(0xFF059669);
secondaryColor = Color(0xFF10B981);
accentColor = Color(0xFF84CC16);
๐Ÿ’œ Royal Purple
primaryColor = Color(0xFF7C3AED);
secondaryColor = Color(0xFF8B5CF6);
accentColor = Color(0xFFEC4899);

๐ŸŽญ Changing the App Icon

1

Prepare Your Icon

  • Size: 1024ร—1024 pixels minimum
  • Format: PNG with transparent background
  • Design: Simple, clean, recognizable at small sizes
  • No text: Avoid text in the icon (it won't be readable)
2

Replace the Icon File

Replace the existing icon with your new one:

assets/icons/app_icon.png
Important: Keep the exact same filename app_icon.png
3

Generate Platform Icons

Let Flutter generate all the required icon sizes:

# Generate icons for all platforms and sizes
flutter pub run flutter_launcher_icons:main
This creates icons for Android, iOS, and other platforms automatically!
4

Test Your New Icon (flutter run, only for emulator)

Build and install to see your icon on the device:

# Clean build to ensure icon changes are applied
flutter clean
flutter run
Your new icon should appear on the home screen!

๐Ÿงช Test Your Visual Changes (Optional, for running the app in emulator)

After making color and icon changes, test your app:

# Apply all visual changes
flutter hot restart
Step 6

Firebase Setup (Optional)

๐Ÿ“Œ

This Step is Completely Optional!

Your app works perfectly without Firebase. Firebase is only needed if you want push notifications. All core features (tasks, AI, categories, etc.) work offline.

๐Ÿ”ฅ What Firebase Provides

๐Ÿ””
Push Notifications

Send reminders and updates to users even when app is closed

๐Ÿ“Š
Analytics (Optional)

Track app usage and user behavior

1๏ธโƒฃ

Create Firebase Project

Go to Firebase Console and create a new project:

  1. Click "Create a project"
  2. Enter your project name (e.g., "MyTodoApp") and click Continue
  3. Enable/disable Google Gemini (your choice) and Click Continue
  4. Enable/disable Google Analytics (your choice) and Click Continue
  5. Select your Firebase account
  6. Click "Create project"
Firebase project creation

Creating a new Firebase project (Click Image to View)

Firebase project creation

Enable Disable Analytics (Click to View image)

2๏ธโƒฃ

Add Android App

In your Firebase project console:

  1. Click "Add app" and select Android
  2. Enter package name: com.mindflow.todo (or your custom package)
  3. Enter app nickname (optional): "MyTodoApp Android"
  4. Click "Register App"
  5. In the next screen, Download the google-services.json file
  6. Place it in your android/app/ folder
๐Ÿ“ Place the file here: android/app/google-services.json
Firebase Adding Android App

Add Android App (Click to View Image)

3๏ธโƒฃ

Add iOS App (Optional)

If you plan to build for iOS:

  1. Click "Add app" and select iOS
  2. Enter bundle ID: com.mindflow.todo (or your custom bundle)
  3. Download the GoogleService-Info.plist file
  4. Place it in your ios/Runner/ folder
๐Ÿ“ Place the file here: ios/Runner/GoogleService-Info.plist
4๏ธโƒฃ

Test Firebase Connection (flutter-run, only for emulator)

Build and run your app to test Firebase:

# Clean build to include Firebase configuration
flutter clean
flutter pub get
flutter run
โœ… Firebase Connected! Your app can now send push notifications.

๐Ÿ’ป Backend Setup (Optional, For Advanced Only)

If you want to send push notifications from a web dashboard, you'll need to set up the included PHP backend. This requires web hosting with PHP and MySQL.

Click to see backend setup instructions

For advanced, who want notification scheduling:

  1. Upload the backend/ folder to your web server
  2. Create a MySQL database
  3. Update database credentials in backend/config/database.php
  4. Generate Firebase service account key and place in backend/config/firebase_credentials.json
Note: This is completely optional. If you don't need the backend skip it.
Step 7

Building Your App

Now that your app is customized, let's build it for distribution. We'll cover different build types for different purposes.

๐Ÿ› ๏ธ

Debug Build

For testing and development

โœ… Fast to build โœ… Includes debugging tools โœ… Hot reload supported
# For development testing in emulator
flutter run

# Or build APK for sharing
flutter build apk --debug
๐Ÿ“ฆ

App Bundle (AAB)

For Play Store upload

โœ… Required by Play Store โœ… Smallest download size โœ… Dynamic delivery
# Build for Play Store
flutter build appbundle --release
๐Ÿ“ Find your AAB here: build/app/outputs/bundle/release/app-release.aab

๐Ÿ—๏ธ Step-by-Step Build Process

1

Clean Your Project

Always start with a clean build to avoid issues:

# Clean previous builds
flutter clean
flutter pub get
2

Choose Your Build Type

For most users, we recommend starting with the release APK:

# Build release APK (recommended for testing)
flutter build apk --release

# OR build AAB for Play Store
flutter build appbundle --release
Flutter Build APK Release

Flutter Release APK (Click to view Image)

3

Find Your Built App

After building, find your app file:

APK Location: build/app/outputs/flutter-apk/app-release.apk
AAB Location: build/app/outputs/bundle/release/app-release.aab
๐ŸŽ‰ Success! You now have a built app ready for installation or store upload!

๐Ÿงช Testing Your Builds

๐Ÿ“ฑ Install APK Directly

# Install on connected device
adb install build/app/outputs/flutter-apk/app-release.apk

# Or transfer APK to device and install manually

๐Ÿ” Validate AAB

Before uploading to Play Store, validate your AAB:

# Download bundletool from Google, then:
bundletool validate --bundle=build/app/outputs/bundle/release/app-release.aab

๐Ÿ”ง Common Build Issues

โŒ "Execution failed for task":

Run flutter clean then try building again.

โŒ "SDK not found":

Run flutter doctor and fix any shown issues.

โŒ Build takes too long:

This is normal for the first build. Subsequent builds will be faster.

Step 8

Play Store Preparation

๐ŸŽ‰

Congratulations! You're Almost Ready!

Your app is fully customized and built. This final step covers Play Store requirements and submission.

โœ… Pre-Submission Checklist

โœ…
App Customization Complete

Your app name, colors, and icon are customized

โœ…
2025 Play Store Compliant

Target SDK 35 (Android 15) - meets all requirements

โœ…
Security Standards Met

HTTPS-only, secure storage, obfuscated code

๐Ÿ“‹
Create Signing Key (Required for Play Store)

You'll need this for Play Store upload - see below

๐Ÿ”‘ App Signing for Play Store

๐Ÿ“Œ Required for Play Store: You must sign your app with your own key before uploading to Play Store. This is a security requirement.
1

Generate Your Signing Key

Create a unique signing key for your app:

# Generate your signing keystore
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
Important: Remember your passwords! You'll need them for future updates.
2

Configure Signing

Create a file android/key.properties with your key details:

storePassword=your-keystore-password
keyPassword=your-key-password
keyAlias=upload
storeFile=../upload-keystore.jks
3

Update Build Configuration

Update android/app/build.gradle.kts to use your signing key:

// Add this before android block
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

// In the android block, update signingConfigs
signingConfigs {
    create("release") {
        keyAlias = keystoreProperties['keyAlias']
        keyPassword = keystoreProperties['keyPassword']
        storeFile = keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
        storePassword = keystoreProperties['storePassword']
    }
}

๐Ÿ—๏ธ Final Signed Build

Build your final, signed AAB for Play Store:

# Build signed AAB for Play Store
flutter build appbundle --release

# Your signed AAB will be at:
# build/app/outputs/bundle/release/app-release.aab
๐ŸŽ‰ Perfect! Your app is now signed and ready for Play Store upload!

๐Ÿ“ฑ Play Store Assets Needed

๐Ÿ“ฑ Screenshots

  • At least 2 phone screenshots
  • 1080 x 1920 or 1080 x 2340 pixels
  • Show key app features

๐ŸŽจ Feature Graphic

  • 1024 x 500 pixels
  • JPG or 24-bit PNG (no alpha)
  • Represents your app brand

๐Ÿ“ App Description

  • Short description (80 chars)
  • Full description (4000 chars)
  • Highlight key features

๐Ÿ” Privacy Policy

  • Required for all apps
  • Must be accessible online
  • Describe data collection

๐Ÿ’ก Submission Tips

๐ŸŽฏ
Start with Internal Testing

Upload your AAB to Play Console and create an internal test first

๐Ÿ“
Complete All Store Sections

Fill out app content, target audience, and privacy sections

โฐ
Review Takes Time

Play Store review can take 1-3 days for new apps

๐Ÿ”„
Be Ready for Updates

Keep your signing key safe - you'll need it for app updates

๐ŸŽ‰ Congratulations!

You've successfully customized and prepared MindFlow for publication!

What you've accomplished:

  • โœ… Fully customized app with your branding
  • โœ… Professional app icon and color scheme
  • โœ… 2025 Play Store compliant build
  • โœ… Secure, optimized, production-ready app
  • โœ… Ready-to-upload AAB file

Your next steps:

  1. Create your Google Play Developer account
  2. Prepare your store assets (screenshots, descriptions)
  3. Upload your AAB to Play Console
  4. Launch your successful todo app!
๐Ÿ”ง

Troubleshooting Guide

๐Ÿšง Installation Issues

โŒ "Flutter not found"

Flutter is not in your system PATH.

# Check if Flutter is installed
flutter --version

# If not found, add Flutter to PATH or reinstall Flutter
โŒ "pub get failed"

Dependencies couldn't be downloaded.

# Clear Flutter cache and try again
flutter clean
flutter pub cache repair
flutter pub get

๐Ÿ—๏ธ Build Issues

โŒ "Execution failed for task"

Common Android build error.

# Clean and rebuild
flutter clean
flutter pub get
flutter build apk --release
โŒ "AAPT error"

Android resource compilation error.

# Update Android build tools
flutter doctor
# Fix any issues shown, then rebuild

๐Ÿ”ฅ Firebase Issues

โŒ Firebase initialization failed

Configuration files not found or incorrect.

  1. Check google-services.json is in android/app/
  2. Verify package name matches Firebase project
  3. Rebuild: flutter clean && flutter pub get

๐Ÿ“ฑ App Runtime Issues

โŒ App crashes on startup

Check device logs for error details.

# View device logs
flutter logs

# Or use adb
adb logcat
โŒ White screen on launch

Usually indicates a startup error.

  1. Run in debug mode: flutter run --debug
  2. Check console for error messages
  3. Verify all assets are included

๐Ÿ” Diagnostic Commands

Check Flutter Environment
flutter doctor -v

Shows detailed information about your Flutter setup

Analyze Code Issues
flutter analyze

Checks your code for common issues and errors

Check Dependencies
flutter pub deps

Shows all dependencies and their versions

๐Ÿ’ฌ

Support & Resources

We're Here to Help! ๐Ÿค

Having issues or questions? Here are all the resources available to help you succeed with MindFlow.

๐Ÿ“–

Documentation First

Start here! This guide covers 95% of common questions and issues.

  • Step-by-step setup instructions
  • Complete troubleshooting guide
  • Customization examples
๐Ÿ’ฌ

CodeCanyon Comments

Ask questions and see what others are building with MindFlow.

  • Community discussions
  • Feature requests
  • Showcase your apps
Response Time: Within 24 hours
๐Ÿ“ง

Direct Email Support

For technical questions and customization help from Zoon11 team.

  • Technical troubleshooting
  • Custom feature development
  • Advanced configuration help
  • Email us at support@zoon11.com
Response Time: Within 48 hours

๐Ÿ“š Additional Learning Resources

๐Ÿฆ‹ Flutter Documentation

Official Flutter docs for learning Flutter development

flutter.dev/docs โ†’

๐Ÿ”ฅ Firebase Documentation

Learn more about Firebase features and setup

firebase.google.com/docs โ†’

๐Ÿค– Android Developers

Official Android development guides and best practices

developer.android.com โ†’

๐Ÿช Google Play Console

Help center for publishing apps on Play Store

Play Console Help โ†’

โ“ Frequently Asked Questions

Can I customize the app without coding knowledge?

Yes! MindFlow is designed for easy customization. You can change colors, app name, icon, and branding by just editing configuration files. No programming knowledge required for basic customization.

Do I need Firebase to use the app?

No! Firebase is completely optional. The app works perfectly for task management without Firebase. Firebase is only needed if you want push notifications.

Can I publish this app on both Android and iOS?

Yes! MindFlow is built with Flutter, which supports both platforms. You can build for Android APK/AAB and iOS IPA from the same codebase.

Is the app compliant with latest store requirements?

Absolutely! MindFlow targets Android API 35 (Android 15) and meets all 2025 Google Play Store requirements. It includes modern security features and best practices.

How do I update the app after publishing?

You can update the app by building a new version with a higher version number in pubspec.yaml, then uploading the new AAB to Play Store. Keep your signing key safe for updates!

๐ŸŒŸ Success Stories

Thank You for Choosing MindFlow!

We're excited to see what amazing apps you'll create with MindFlow. When you publish your app, let us know - we love featuring successful MindFlow-powered apps!

๐Ÿ’ก Tips for Success:
  • ๐ŸŽฏ Focus on your target audience
  • ๐Ÿ“ฑ Test thoroughly on different devices
  • ๐Ÿ“ˆ Monitor user feedback and iterate
  • ๐Ÿ”„ Regular updates keep users engaged

๐Ÿš€ Ready to Launch!

You now have everything needed to create and publish a successful todo app.

Before you go, make sure you have:

  • โœ… Customized your app branding
  • โœ… Built and tested your app
  • โœ… Prepared your signing key
  • โœ… Created your store assets

Best of luck with your app! ๐Ÿ€

- The Zoon11 Team