Welcome to zzz
Quick setup guide to get you started with zzz development environment.
Quick Note
Welcome to zzz, For support, Discord links, and additional resources, check the customer portal. Issues or suggestions? We're listening and improving continuously.
Current Support: Windows + Android apps (Kotlin, Flutter). Other frameworks and OS support coming soon based on feedback.
AI Assistant Setup
Configure your AI assistant to help with code generation and development tasks.
OpenRouter Configuration
1. Create an OpenRouter account
Visit OpenRouter API Keys to get your API key.
Visit OpenRouter API Keys to get your API key.
2. Copy your API key
Remember you can only copy it fully once, so store it securely. You can always create another one if needed.
Remember you can only copy it fully once, so store it securely. You can always create another one if needed.
3. Configure in zzz
Go to IDE Settings β AI Assistant Settings and paste your API key.
Go to IDE Settings β AI Assistant Settings and paste your API key.
4. Choose your model
Want a different model? Visit OpenRouter Models and copy the model name from the icon next to the name (e.g.,
Want a different model? Visit OpenRouter Models and copy the model name from the icon next to the name (e.g.,
mistralai/devstral-medium
).
π§ͺ Beta Feature: UI Builder Toggle
- Located at the top of the AI Assistant panel.
- When enabled, the assistant analyzes your app context (colors, methods, layouts) to generate UI screens.
- This feature is experimental and may hallucinate or break layouts.
- Always keep a checkpoint or commit before applying generated changes.
- With the toggle off, the assistant behaves normally for coding tasks only.
Device Testing Setup
Set up your Android device for testing and debugging your applications.
Android Device Configuration
1. Enable Developer Options
Go to Settings β About Phone β tap Build Number 7 times to activate developer settings.
Go to Settings β About Phone β tap Build Number 7 times to activate developer settings.
2. Enable USB Debugging
Go to Settings β Developer Options β enable USB Debugging.
Go to Settings β Developer Options β enable USB Debugging.
3. Connect your device
Use a data transfer cable (not just a charging cable) to connect your device to your PC, then open zzz.
Use a data transfer cable (not just a charging cable) to connect your device to your PC, then open zzz.
4. Install and test
When your app compiles, accept the install prompt on your phone.
When your app compiles, accept the install prompt on your phone.
β‘ Flutter Hot Reload
- Run your Flutter app on a connected device.
- Make changes to your code in the IDE.
- Press the Hot Reload button to instantly apply updates without restarting the entire app.
- This preserves app state and speeds up the development cycle significantly.
Security Settings & APK Installation
β οΈ Common Installation Issues
The most common problem when testing apps is Android's security system blocking APK installations. This is normal behavior and can be resolved by adjusting security settings.
Allow installations from unknown sources:
β’ Go to Settings β Security β Unknown Sources (or Install Unknown Apps)
β’ Enable the option to allow installations from unknown sources
β’ Some devices may ask you to allow this per-app basis when you try to install
β’ Go to Settings β Security β Unknown Sources (or Install Unknown Apps)
β’ Enable the option to allow installations from unknown sources
β’ Some devices may ask you to allow this per-app basis when you try to install
If you get "App not installed" or "Package installer blocked":
β’ Check if Play Protect is blocking the installation
β’ Go to Google Play Store β Menu β Play Protect β Settings
β’ Temporarily disable "Scan apps with Play Protect" for testing
β’ Re-enable it after testing for security
β’ Check if Play Protect is blocking the installation
β’ Go to Google Play Store β Menu β Play Protect β Settings
β’ Temporarily disable "Scan apps with Play Protect" for testing
β’ Re-enable it after testing for security
For Samsung devices:
β’ Go to Settings β Apps β Menu β Special access β Install unknown apps
β’ Select the app you want to allow installations from (usually File Manager or Browser)
β’ Toggle on "Allow from this source"
β’ Go to Settings β Apps β Menu β Special access β Install unknown apps
β’ Select the app you want to allow installations from (usually File Manager or Browser)
β’ Toggle on "Allow from this source"
For Xiaomi/MIUI devices:
β’ Go to Settings β Additional settings β Privacy β Unknown sources
β’ Enable the toggle
β’ You may also need to disable MIUI optimization in Developer options
Xiaomi Security App blocking:
β’ If you get a popup from the security app saying "APK blocked"
β’ Tap "Allow" on the popup to permit the installation
β’ If no popup appears, open the Security app β Permissions β App installation
β’ Find the blocked APK in the list (select the APK file, not the medium/source)
β’ Tap on the specific APK and select "Allow" to unblock it
β’ Go to Settings β Additional settings β Privacy β Unknown sources
β’ Enable the toggle
β’ You may also need to disable MIUI optimization in Developer options
Xiaomi Security App blocking:
β’ If you get a popup from the security app saying "APK blocked"
β’ Tap "Allow" on the popup to permit the installation
β’ If no popup appears, open the Security app β Permissions β App installation
β’ Find the blocked APK in the list (select the APK file, not the medium/source)
β’ Tap on the specific APK and select "Allow" to unblock it
π‘ Pro Tip
After testing, remember to re-enable your security settings to keep your device protected. Only install APKs from trusted sources in production.
Interoperability
Setting up a Kotlin or Flutter project opened in zzz for the first time.
SDK Setup from Other IDEs
1. Open the project folder:
Use
Use
Ctrl + 1
to open the file modal and select your project folder (Kotlin or Flutter).
2. Open SDK Manager:
Press
Press
Ctrl + M
to open the settings modal, then select the SDK Manager tab.
3. Detect SDK versions:
In the SDK Manager, click on Detect Versions.
In the SDK Manager, click on Detect Versions.
4. Install missing versions:
Once SDK versions are shown, click Install for any that are missing or use Install All if none are installed.
Once SDK versions are shown, click Install for any that are missing or use Install All if none are installed.
5. Restart zzz:
After installation completes, restart zzz to apply changes.
After installation completes, restart zzz to apply changes.
6. Start development:
You can now develop your Kotlin or Flutter app normally.
You can now develop your Kotlin or Flutter app normally.
π‘ Tip
If your project still wonβt build, ensure the correct JDK, Gradle, or Flutter SDK settings are detected after the restart.
If any issues persist, check the Support section.
Troubleshooting
Common issues and their solutions.
Device Connection Issues
Device not recognized:
β’ Ensure you're using a data cable, not just a charging cable
β’ Try different USB ports on your computer
β’ Install your device manufacturer's USB drivers
β’ Check if USB debugging is enabled
β’ Ensure you're using a data cable, not just a charging cable
β’ Try different USB ports on your computer
β’ Install your device manufacturer's USB drivers
β’ Check if USB debugging is enabled
"Unauthorized" message:
β’ Look for an authorization dialog on your phone
β’ Tap "Always allow from this computer" and OK
β’ If no dialog appears, revoke USB debugging authorizations in Developer Options and reconnect
β’ Look for an authorization dialog on your phone
β’ Tap "Always allow from this computer" and OK
β’ If no dialog appears, revoke USB debugging authorizations in Developer Options and reconnect
Build & Installation Issues
Build failures:
β’ Check that all dependencies are properly configured
β’ Ensure your Android SDK is up to date
β’ Clean and rebuild your project
β’ Check that all dependencies are properly configured
β’ Ensure your Android SDK is up to date
β’ Clean and rebuild your project
Installation blocked:
β’ Review the security settings section in Device Testing
β’ Check if your antivirus software is blocking the installation
β’ Temporarily disable Play Protect during testing
β’ Review the security settings section in Device Testing
β’ Check if your antivirus software is blocking the installation
β’ Temporarily disable Play Protect during testing
Support
Need help? Here's how to get support and connect with the community.
Getting Help
Customer Portal:
Access Discord links, additional resources, and submit feedback through the customer portal.
Access Discord links, additional resources, and submit feedback through the customer portal.
Discord Community:
Join our Discord server for real-time support, discussions, and community help.
Join our Discord server for real-time support, discussions, and community help.
Feature Requests:
Suggestions for new features or improvements are welcomed and actively considered for future development based on user feedback.
Suggestions for new features or improvements are welcomed and actively considered for future development based on user feedback.