FlutterFlow Marketplace Metadata Generator
Overview
This BuildShip workflow automates the generation of marketplace metadata for FlutterFlow projects. It analyzes your FlutterFlow project files and creates comprehensive marketplace-ready content including titles, descriptions, feature lists, usage instructions, tags, and promotional banner images.
Features
- Automated Project Analysis: Downloads and extracts FlutterFlow project YAML files
- AI-Powered Metadata Generation: Uses Groq AI to analyze project structure and generate marketing content
- Banner Image Creation: Generates professional marketplace banner images using Replicate AI
- Structured Output: Returns all metadata in a standardized format ready for marketplace submission
Workflow Components
1. REST API Trigger
- Endpoint:
/marketplaceMetadata
- Method: POST
- Content-Type: application/json
2. FlutterFlow Project Extractor
- Downloads project files using FlutterFlow API
- Extracts YAML configuration files
- Processes project structure for analysis
3. AI Content Generator (Groq)
- Analyzes project YAML files
- Generates marketing-focused descriptions
- Identifies key features and functionality
- Creates usage instructions and tags
4. Banner Image Generator (Replicate)
- Creates promotional banner images
- Uses AI image generation (Ideogram v3)
- Customizable style references
- 3 aspect ratio optimized for marketplace
API Usage
Request
POST /marketplaceMetadata
Content-Type: application/json
{
"projectId": "your-flutterflow-project-id",
"styleReferenceImage": "https://example.com/style-reference.jpg"
}
Parameters
projectId (string, required)
- Your FlutterFlow project ID (e.g., "api-dev-2kln1x")
- Must follow the pattern: lowercase letters, numbers, and hyphens only
styleReferenceImage (string, optional)
- URL to an image for style reference in banner generation
- Used to influence the visual style of the generated marketplace banner
- Should be a publicly accessible image URL
Response
{
"title": "Your App Title",
"description": "Detailed app description (max 1500 characters)",
"topFeatures": [
"Feature 1",
"Feature 2",
"Feature 3"
],
"usageInstructions": "Step-by-step usage instructions (max 1500 characters)",
"tags": [
"tag1",
"tag2",
"tag3"
],
"marketplaceImageUrl": "https://generated-banner-image-url.jpg"
}
Setup Requirements
API Keys Required
- FlutterFlow API Key
- Obtain from your FlutterFlow account settings
- Required for project file access
- Groq API Key
- Replicate API Key
Configuration
- Import the workflow into your BuildShip account
- Configure the required API keys in the integration settings:
- FlutterFlow:
flutterflow-key-sgardoll
- Groq:
groq-key-scriptsafe
- Replicate:
replicate-key-stuart
AI Models Used
- Content Generation: Llama 3.3 70B (via Groq)
- Image Generation: Ideogram v3 Balanced (via Replicate)
Example Use Cases
For FlutterFlow Developers
- Marketplace Submissions: Automatically generate all required metadata for FlutterFlow Marketplace
- App Documentation: Create standardized descriptions and feature lists
- Marketing Materials: Generate promotional content and images
For Development Teams
- Project Documentation: Maintain consistent project descriptions
- Feature Tracking: Auto-extract and list app capabilities
- Visual Assets: Generate consistent banner images for multiple projects
Workflow Logic
- Input Validation: Validates project ID format and parameters
- Project Extraction: Downloads and extracts YAML files from FlutterFlow
- Content Analysis: AI analyzes project structure to understand functionality
- Metadata Generation: Creates marketing-focused content based on analysis
- Image Generation: Generates promotional banner with project-specific styling
- Output Formatting: Returns structured metadata ready for marketplace use
Error Handling
The workflow includes comprehensive error handling for:
- Invalid project IDs
- API authentication failures
- File extraction issues
- AI generation errors
- Network connectivity problems
Performance
- Average Processing Time: 30-60 seconds
- File Size Limits: Up to 32MB for project files
- Rate Limits: Respects FlutterFlow and AI service rate limits
Best Practices
Input Optimization
- Use clear, descriptive project names in FlutterFlow
- Include meaningful widget names and comments in your project
- Organize your project structure logically
Style Reference Images
- Use high-quality reference images (minimum 1024x768)
- Choose images that represent your app's visual style
- Avoid copyrighted or branded content
Project Preparation
- Ensure your FlutterFlow project is complete and functional
- Test all major features before generating metadata
- Include relevant custom code documentation
Troubleshooting
Common Issues
"No project_yaml_bytes found"
- Verify project ID is correct
- Ensure FlutterFlow API key has proper permissions
- Check that project exists and is accessible
"Invalid JSON content returned"
- AI model may have generated malformed content
- Retry the request
- Check project files for unusual characters
"Failed to obtain access token"
- Verify API keys are correctly configured
- Check BuildShip integration settings
- Ensure all required permissions are granted
Support
For issues specific to this workflow:
- Check BuildShip workflow logs
- Verify all API keys are valid and have proper permissions
- Ensure your FlutterFlow project is accessible via API
For FlutterFlow Marketplace submissions:
License
This workflow is provided as-is for FlutterFlow development purposes. Ensure compliance with all relevant API terms of service for FlutterFlow, Groq, and Replicate.
