Documentation
ZenCode AI Documentation
Welcome to the ZenCode AI documentation. Learn how to get started, use advanced features, and troubleshoot common issues.
📚 Table of Contents
🚀 Getting Started
Installation
- Download the ZenCode AI plugin (ZenCodeAI.zip)
- Go to WordPress Admin → Plugins → Add New
- Click “Upload Plugin” and select ZenCodeAI.zip
- Click “Install Now” then “Activate”
- You’ll see “ZenCode AI” in your WordPress admin menu
First-Time Setup
- Click “ZenCode AI” in your WordPress menu
- Enter your Google API key (see below for how to get one)
- Choose your default preferences
- Click “Save Settings”
- You’re ready to build!
🔑 Google API Setup
Getting Your Google API Key
- Go to Google Cloud Console
- Create a new project or select existing one
- Enable the “Gemini API”
- Go to “Credentials” and create an API key
- Copy the API key
- Paste it into ZenCode AI settings
⚠️ IMPORTANT: Free vs Paid Tier
Google’s Free Tier is for PERSONAL USE ONLY
- ✅ Free tier: Personal projects, learning, experimentation
- ❌ Free tier: Client work, products for sale, commercial applications
- ✅ Paid tier required for: Any commercial use, selling products, client projects
API Cost Management
- Set budget alerts in Google Cloud Console
- Monitor usage in the API dashboard
- Typical costs: $10-30/month for normal use
- Heavy use can cost more – monitor closely
💻 Creating Projects
Method 1: Text Description
- Click “New Project” in ZenCode AI
- Enter a project name
- Describe what you want to build in plain English
- Click “Generate Project”
- Review the generated files
- Make adjustments as needed
Method 2: Image-to-Plan
- Click “New Project”
- Upload a screenshot of a website or design
- ZenCode AI analyzes the image
- Generates a complete technical specification
- Click “Run Entire Plan” to build automatically
- Watch your project build itself!
Editing Projects
- Use the built-in code editor
- Ask AI to make changes in natural language
- AI understands context of your entire project
- Auto-repair fixes errors automatically
Exporting Projects
- Open your project
- Click “Export as ZIP”
- Download includes all files with proper structure
- Deploy anywhere – no vendor lock-in
⚡ Advanced Features
Auto-Repair System
- Automatically detects errors in your code
- Suggests fixes or applies them automatically
- Learns from successful repairs
- Reduces debugging time by 80%
Learning Knowledge Base
- Stores successful patterns from your projects
- Learns your coding style and preferences
- Improves suggestions over time
- After 10+ projects, feels like a senior dev who knows you
Multi-Language Support
- PHP, JavaScript, CSS, HTML
- Python, TypeScript, React, Vue
- AI understands relationships between files
- Works across languages in single project
Project Templates
- Start with pre-built templates
- WordPress themes and plugins
- Landing pages
- Web applications
- Custom templates (create your own)
🔧 Troubleshooting
API Key Issues
Problem: “Invalid API Key” error
Solution:
- Verify the key is copied correctly (no extra spaces)
- Ensure Gemini API is enabled in Google Cloud
- Check if your key has restrictions that block the plugin
- Generate a new API key if needed
Quota Exceeded Errors
Problem: “Quota exceeded” or “Rate limit” errors
Solution:
- Check your Google Cloud Console for quota limits
- Upgrade to paid tier if on free tier
- Wait for quota to reset (usually 1 minute)
- Reduce frequency of large requests
Code Generation Errors
Problem: Generated code has errors
Solution:
- AI can make mistakes – it’s normal
- Use auto-repair feature to fix
- Provide more specific instructions
- Break large tasks into smaller steps
- Review and test all generated code
Plugin Not Appearing
Problem: Can’t find ZenCode AI in WordPress menu
Solution:
- Verify plugin is activated
- Check your user role (must be Administrator)
- Clear browser cache
- Check for plugin conflicts
- Deactivate other plugins temporarily to test
Export Not Working
Problem: Can’t export project as ZIP
Solution:
- Check PHP memory limits (increase if needed)
- Verify write permissions on uploads folder
- Try exporting smaller projects first
- Contact support if issue persists
❓ Frequently Asked Questions
Do I need coding experience?
No! ZenCode AI works for beginners and experts. Beginners can use natural language descriptions. Experienced developers benefit from intelligent code completion and rapid prototyping.
How much do API costs typically run?
Most users spend $10-30/month on Google API costs for unlimited projects. Costs vary based on usage. You can set budget alerts in Google Cloud Console.
Can I use the free Google API tier?
Yes, but ONLY for personal, non-commercial projects. If you’re building products to sell or client work, you MUST use the paid tier per Google’s terms.
Do you have access to my projects?
No. All your projects, code, and AI conversations are stored locally on YOUR WordPress server. We never see your data.
Can I export and use projects elsewhere?
Yes! Export any project as a complete ZIP file. Deploy anywhere. You own 100% of the code with no vendor lock-in.
What happens if I don’t renew my license?
After license expiration, you can’t create new projects, but your existing projects remain accessible. You have 30 days to renew before permanent deactivation.
Does the AI make mistakes?
Yes, AI can make mistakes. Always review and test generated code. Use the auto-repair feature for common issues. The AI learns and improves over time.
Can I use this for client work?
Yes, but you MUST use Google’s paid API tier for commercial work. The free tier is personal use only.
Is there a limit on projects?
No limit! Create unlimited projects during your active license period.
Do you offer refunds?
Yes, 30-day money-back guarantee for legitimate technical issues. See our Refund Policy for full details.
📧 Need More Help?
If you can’t find what you’re looking for:
- Email support: [Your Email]
- Check our blog for tutorials
- Join our community forum
- Watch video tutorials (coming soon)
Support Response Time: We typically respond within 24-48 hours on business days.