Template Marketplace User Guide¶

Overview¶

The Template Marketplace enables users to deploy pre-built applications in approximately 15 minutes. Browse 10-15 curated templates, customize with your branding, and execute workflows to generate fully-functional applications.

Quick Start¶

1. Browse Templates¶

Navigate to: Dashboard → Templates

Actions: - View template cards with screenshots and descriptions - Filter by category: Business, Dashboard, Landing Page, E-Commerce - Search by name or keyword - View template details (click card)

Template Information: - Name and description - Required variables (app_name, primary_color, company_logo) - Total installations and average rating - Estimated execution time (5-15 minutes) - Estimated cost ($0.50-$5.00)

2. Instantiate Template¶

Steps: 1. Click "Use Template" button 2. Fill in required variables: - App Name: Your application name - Primary Color: Brand color (hex code or color picker) - Company Logo: Upload or select from assets 3. Review asset mappings (auto-populated from your assets) 4. Click "Create Instance"

What Happens: - Template Service validates variables - Assets are projected (symlinked) into template structure - Template instance created in "draft" status - You're redirected to instance details page

3. Execute Template¶

Steps: 1. Review instance configuration 2. Click "Execute Workflow" button 3. Monitor progress in real-time (progress bar, step-by-step)

Workflow Stages: - Database schema creation (30 seconds) - API endpoint generation (60 seconds) - UI component generation (90 seconds) - Integration configuration (30 seconds) - Deployment (60 seconds)

Total Time: 5-15 minutes depending on template complexity

4. Access Your Application¶

Once Complete: - View application URL (a generated hostname is issued on deploy; the underlying hosting substrate is an implementation detail and must not be quoted in customer docs) - Download generated code (ZIP file) - View deployment logs - Configure custom domain (optional)

Template Categories¶

Business Templates¶

CRM System: Lead tracking, pipeline management, customer communication
Invoice Manager: Invoice creation, payment tracking, reporting
Project Tracker: Project management, task assignment, progress tracking

Dashboard Templates¶

Analytics Dashboard: Data visualization, charts, real-time metrics
Admin Panel: User management, settings, system monitoring

Landing Page Templates¶

Marketing Landing Page: Hero section, features, testimonials, contact form
Product Launch Page: Product showcase, pricing, FAQ, newsletter signup

E-Commerce Templates¶

Online Store: Product catalog, shopping cart, checkout, payment integration

Customization Options¶

Required Variables¶

All templates require: - app_name: Application name (displayed in UI) - primary_color: Brand color (hex code, e.g., #3B82F6)

Optional variables (depends on template): - company_logo: Upload or select from your assets - font_family: Typography choice (Inter, Roboto, Poppins) - company_name: Your company name - contact_email: Support email address

Asset Projection¶

How it works: 1. Upload assets to Asset Manager (Dashboard → Assets) 2. Assets get SHA256 hash (e.g., sha256:abc123...) 3. Select asset in template instantiation form 4. Template Service creates symlink (not copy) to your asset 5. If you update the asset, all template instances automatically use new version

Supported asset types: - Images: PNG, JPG, SVG (logos, icons, backgrounds) - Fonts: TTF, WOFF, WOFF2 - Stylesheets: CSS files - Documents: PDF, DOCX (for content)

Workflow Monitoring¶

Real-Time Progress¶

During Execution: - Progress bar (0-100%) - Current step indicator - Step-by-step status (pending, running, completed, failed) - Cost tracking ($0.00 → estimated total) - Time remaining estimate

WebSocket Updates: - Automatically updates every 2 seconds - No page refresh needed - Step completion notifications

Workflow Details¶

View: - All workflow steps with status - Duration per step - Cost per step - Retry count (if step failed) - Error messages (if any)

Actions: - Pause workflow (checkpoint) - Resume workflow - Retry failed step - View step output

Custom Templates¶

Create Your Own Template¶

Navigate to: Templates → Create Custom Template

Steps: 1. Enter template metadata: - Name, description, category - RIASEC alignment (Realistic, Investigative, Artistic, Social, Enterprising, Conventional) 2. Define variables: - Variable name, type (string, number, color, asset) - Required or optional - Default value 3. Define workflow steps: - Step number, action type - Configuration (JSON) - Dependencies (which steps must complete first) 4. Test template with sample data 5. Publish to marketplace (private or public)

Publishing Options: - Private: Only you can use this template - Organization: All users in your org can use - Public: Available in marketplace for all users

Template Versioning¶

How it works: - Each template can have multiple versions - Existing instances continue using original version - New instances use latest version by default - You can rollback to previous version if needed

Best Practice: Test new versions thoroughly before publishing

Troubleshooting¶

Template instantiation fails with "Missing required variables"¶

Solution: Ensure all required variables are filled in the form. Check for red validation messages.

Asset projection fails with "Asset not found"¶

Solution: 1. Verify asset exists in Asset Manager 2. Check SHA256 hash is correct 3. Ensure you have access to the asset (not deleted, not from another org)

Workflow execution stuck at checkpoint¶

Solution: 1. Check if approval required (checkpoint indicator) 2. Click "Approve" or "Resume" button 3. If checkpoint expired (> 24 hours), restart workflow

Generated application doesn't reflect my branding¶

Solution: 1. Verify primary_color variable was set correctly 2. Check company_logo asset is accessible 3. Re-instantiate template with correct variables

Best Practices¶

Before Instantiation¶

Review template details: Understand what the template does
Prepare assets: Upload logos, fonts before starting
Choose colors: Have brand colors ready (hex codes)
Estimate cost: Review estimated cost before executing

During Execution¶

Monitor progress: Watch for errors in real-time
Don't close browser: Keep tab open during workflow execution
Check notifications: Enable browser notifications for completion alerts

After Completion¶

Test application: Visit generated URL, test key features
Review code: Download ZIP, review generated files
Configure custom domain: Set up your own domain (optional)
Share with team: Invite team members to use application

FAQs¶

Q: How much does template instantiation cost? A: Cost varies by template and is shown as an estimate before you commit. It covers AI generation, deployment, and hosting. (Specific prices and included hosting duration are set by the current plan matrix — do not quote figures here; link to the pricing page.)

Q: Can I modify generated code? A: Yes! Download ZIP file, modify code locally, redeploy to your own infrastructure.

Q: What happens if workflow fails? A: Failed steps automatically retry (up to 3 attempts). If all retries fail, workflow stops. You can manually retry the failed step.

Q: Can I share custom templates with other users? A: Yes! Publish template to marketplace (public) or share with your organization (org-level).

Q: How long are generated applications hosted? A: Paid plans keep your application live for as long as the subscription is active. Free-plan hosting is time-limited — see the pricing page for the current duration (do not hard-code a number here; it changes with the plan matrix).

Q: Can I deploy to my own infrastructure? A: Yes! Download generated code (ZIP) and deploy anywhere (Cloud Run, Kubernetes, VPS).

Getting Help¶

Support: support@magieva.com
Community: Discord

Last Updated: 2026-02-07 Related Guides: Workflow Builder Guide, Application Generator Guide