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.
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.
3. Configure in zzz
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., 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.
2. 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.
4. Install and test
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
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
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"
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
πŸ’‘ 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 Ctrl + 1 to open the file modal and select your project folder (Kotlin or Flutter).
2. Open SDK Manager:
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.
4. Install missing versions:
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.
6. Start development:
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
"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

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
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

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.
Discord Community:
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.