💡 FAQ & Troubleshooting

1️⃣ How do I install and configure AeroKites Edu?

Follow the Setup & Installation Guide for step-by-step instructions on setting up Flutter 3.35.6, Firebase, and Firestore. The guide covers Android, Web, and iOS setup procedures.

2️⃣ What are the system requirements for AeroKites Edu?

Flutter 3.35.6, Dart 3.9.2, Node.js 18.x or higher, Firebase CLI, and Firebase Console Account. For iOS development, you'll need Xcode 16.x and macOS.

3️⃣ I am getting a Firebase authentication error. How do I fix it?

Ensure that Firebase is properly configured in your firebase_options.dart file and that your API keys match your Firebase Console setup. Also verify that you've created the required Firestore collections as outlined in the setup guide.

4️⃣ Why is my email notification system not working?

Check if Custom SMTP settings are properly configured in the app's Settings > Email Settings. You need to configure SMTP host, port, username, password, and sender details. The app uses custom SMTP, not Brevo.

🔧 Common SMTP Issues & Solutions:
• Connection Timeout: If you see "Unexpected socket close" errors, try switching between port 587 (TLS) and 465 (SSL)
• Port 587: Usually works without SSL checked (TLS encryption)
• Port 465: Requires SSL to be checked
• Gmail: Requires app-specific password, not regular password
• Verify credentials: Double-check username, password, and SMTP host

📧 Popular SMTP Settings:
• Gmail: smtp.gmail.com:587 (TLS, no SSL)
• Outlook: smtp-mail.outlook.com:587 (TLS, no SSL)
• Yahoo: smtp.mail.yahoo.com:587 (TLS, no SSL)

5️⃣ How do I fix "Unexpected socket close" SMTP errors?

This error occurs when the SMTP connection times out. Quick fixes:
• Switch ports: Try port 587 (TLS) instead of 465 (SSL) or vice versa
• SSL settings: Port 587 = no SSL, Port 465 = SSL checked
• Test connection: Use the "Test Connection" button in Email Settings
• Check firewall: Ensure your server allows outbound SMTP connections
• Provider limits: Some email providers have rate limits or connection restrictions

6️⃣ How do I configure AI features in the app?

You need to set up OpenAI API by registering at platform.openai.com, getting your API key and Organization ID, then configuring them in the app's Settings > AI Settings. See the AI Assistant Settings Guide for detailed steps.

7️⃣ Can I customize the app UI and add new features?

Yes! The source code is 100% customizable. You can modify UI components and logic inside the lib/ folder of the Flutter project. The app is built with Flutter 3.35.6 and supports cross-platform development.

8️⃣ How do I deploy the web version of the app?

Use Firebase Hosting to deploy the web version. Run flutter build web to build the web version, then deploy using firebase deploy --only hosting. Make sure to configure Firebase Hosting in your Firebase Console.

9️⃣ What payment gateways are supported?

The app supports Razorpay and Stripe payment gateways. You need to configure your payment gateway credentials in the app's Settings > Payment Gateway Settings and set up webhook URLs after deploying the cloud functions.

🔟 How do I manage multiple currencies in the app?

The app supports multi-currency fee management. You can configure different currencies in the Settings > Payment Gateway Settings screen. The system allows you to set up fee structures in multiple currencies for international schools.

1️⃣1️⃣ I need technical support. How can I get help?

If you purchased AeroKites Edu from Envato CodeCanyon, you are eligible for 6 months of free support. You can contact us via:
📧 Email: info@aerokitestech.com
🌍 Website: www.aerokitestech.com