App Builder (Plugin Manager & AI Plugin Builder) Overview

Apps Getting Started Updated February 21, 2026 5 views

App Builder Overview

Create custom business applications in minutes using conversational AI—no coding experience required. The App Builder combines a powerful Plugin Manager with an AI-powered builder that turns plain-English descriptions into fully functional, production-ready apps integrated with your MangoApps Workforce platform.

What is the App Builder?

The App Builder enables organizations to extend MangoApps Workforce with custom applications tailored to their unique business needs. Using a conversational AI agent, administrators describe what they want in plain English and watch as the AI designs, builds, validates, and deploys a complete application—with dashboards, data storage, email notifications, scheduled jobs, and deep platform integrations.

Once deployed, the Plugin Manager provides full lifecycle management: health monitoring, analytics, version control, rollback, and an improvement engine that suggests optimizations.

Core Value Proposition:

🤖 AI-First Development — Describe your app in plain English; the AI builds it end-to-end
⚡ Minutes, Not Months — Go from idea to deployed app in a single conversation
🔗 Deep Platform Integration — Apps access shifts, schedules, attendance, leave, users, and more
🛡️ Enterprise-Grade Operations — Health monitoring, rollback, audit logs, and security scanning

At a Glance

🧩 Template Gallery	⏱️ Build Time	🔗 Platform APIs	📊 Health Monitoring
20+ starter templates	Minutes via AI	16+ read APIs	Real-time dashboards

Perfect For:

🏢 Administrators — Build custom tools for HR, finance, operations, and analytics without IT tickets
🔧 Operations Teams — Automate equipment tracking, onboarding checklists, approval workflows, and reporting
📊 Managers — Create department-specific dashboards pulling live data from shifts, attendance, and leave

How It Works

AI Plugin Builder Flow

┌───────────────────────────────────────────────────────────────────────────────┐
│                          AI PLUGIN BUILDER WORKFLOW                            │
├───────────────────────────────────────────────────────────────────────────────┤
│                                                                               │
│  ┌────────────┐    ┌─────────────┐    ┌────────────┐    ┌────────────────┐   │
│  │  DESCRIBE  │───▶│  AI BUILDS  │───▶│  VALIDATE  │───▶│    DEPLOY     │   │
│  │ (Plain     │    │ (Streaming  │    │ (Syntax +  │    │ (One-Click    │   │
│  │  English)  │    │  real-time) │    │  Security) │    │  production)  │   │
│  └────────────┘    └─────────────┘    └────────────┘    └───────┬────────┘   │
│        │                                                        │            │
│        │                ┌──────────────────┐                    │            │
│        └───────────────▶│    ITERATE       │◀───────────────────┘            │
│                         │ (Refine with     │                                 │
│                         │  follow-ups)     │                                 │
│                         └──────────────────┘                                 │
│                                                                               │
│  After Deploy:                                                                │
│  ┌────────────┐    ┌─────────────┐    ┌────────────┐    ┌────────────────┐   │
│  │  VERIFY    │───▶│  AUTO-FIX   │───▶│  MONITOR   │───▶│   IMPROVE     │   │
│  │ (Runtime   │    │ (Up to 3    │    │ (Health +  │    │ (AI suggests  │   │
│  │  checks)   │    │  retries)   │    │  analytics)│    │  upgrades)    │   │
│  └────────────┘    └─────────────┘    └────────────┘    └────────────────┘   │
│                                                                               │
└───────────────────────────────────────────────────────────────────────────────┘

Plugin Lifecycle

┌─────────────────────────────────────────────────────────────────────────┐
│                        PLUGIN LIFECYCLE                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐ │
│  │  CREATE   │  │  DEPLOY  │  │  ENABLE  │  │  MANAGE  │  │  RETIRE  │ │
│  │          │  │          │  │          │  │          │  │          │ │
│  │ • AI     │  │ • File   │  │ • Toggle │  │ • Health │  │ • Disable│ │
│  │   Build  │  │   write  │  │ • Install│  │ • Rollback│ │ • Purge │ │
│  │ • ZIP    │  │ • Package│  │ • Hooks  │  │ • Upgrade│  │ • Remove│ │
│  │   Upload │  │ • Verify │  │   run    │  │ • Monitor│  │ • Unhook│ │
│  │ • Import │  │ • Restart│  │          │  │          │  │         │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘  └─────────┘ │
│       │             │             │             │                      │
│       ▼             ▼             ▼             ▼                      │
│     draft ──────▶ active ──────▶ enabled ──── running ──── disabled   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Integration Ecosystem

                              ┌─────────────────┐
                              │   APP BUILDER   │
                              │   (Plugins)     │
                              └────────┬────────┘
                                       │
         ┌─────────────┬───────────────┼───────────────┬─────────────┐
         ▼             ▼               ▼               ▼             ▼
   ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
   │ Schedules │ │Attendance │ │   Leave   │ │   Users   │ │  Ask AI   │
   │ & Shifts  │ │ & Time    │ │ Requests  │ │ & Org     │ │  (Agent)  │
   └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
         │             │             │             │             │
         ▼             ▼             ▼             ▼             ▼
   ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
   │Read shift │ │Track hours│ │Leave      │ │Department │ │Expose     │
   │data &     │ │& overtime │ │analytics  │ │& location │ │plugin data│
   │schedules  │ │patterns   │ │& balances │ │queries    │ │via chat   │
   └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘

Key Features

🤖 AI Plugin Builder

Build complete applications through conversation with an AI agent powered by Claude.

Feature	Description
Conversational Building	Describe your app in plain English and watch it take shape in real-time
Streaming Progress	See AI thinking, code generation, and tool execution live via ActionCable
17 Specialized Tools	AI uses tools for SDK docs, syntax validation, security scanning, deployment, and more
Auto-Fix Loop	If validation fails after deployment, the AI automatically diagnoses and fixes issues (up to 3 retries)
Iterative Refinement	Send follow-up messages to refine, add features, or fix issues in the same session
Surgical Edits	AI patches only what changed—no unnecessary file regeneration
Session Management	Resume previous sessions, search history, rename sessions
File Editor	Manually edit generated files before deploying
Download as ZIP	Export your plugin source code for external development

Use Case: An HR manager describes “Build me an onboarding checklist tracker where managers assign tasks to new hires with due dates and completion status.” The AI reads SDK documentation, plans the architecture, generates all files (plugin definition, controllers, views, email templates), validates syntax, runs a security scan, and presents a ready-to-deploy app—all in under 5 minutes.

📋 Template Gallery

Jumpstart development with 20+ pre-built templates across 9 categories.

Category	Templates	Difficulty
Getting Started	Hello World, Simple Counter	Beginner
CRUD	Equipment Tracker, Inventory Manager, Team Kudos	Intermediate
Analytics	Overtime Dashboard, Leave Analytics	Intermediate
Notifications	Slack Notifier, Schedule Alerts, Daily Digest	Intermediate–Advanced
Automation	Approval Flow	Advanced
HR	Onboarding Checklist, Training Tracker	Intermediate
Finance	Expense Tracker, Mileage Logger	Beginner–Intermediate
Integrations	Webhook Relay, Cross-Plugin Dashboard	Advanced

Custom Templates: Save any AI-generated plugin as a reusable template for your organization. Track template usage across your business.

🔧 Plugin Manager

Full lifecycle management for all plugins—system and custom.

Feature	Description
Unified Plugin List	View all system and customer plugins in one place with status, version, and health
Enable/Disable Toggle	Instantly enable or disable any plugin with lifecycle hooks (`on_install`, `on_activate`, `on_deactivate`)
ZIP Upload	Upload custom plugin packages (10MB limit, 500 file max, structural validation)
Version Tracking	Plugin packages track version history with checksums
Deploy & Restart	One-click deployment triggers server reload for code changes
Marketplace	Browse and install plugins shared by other businesses
Data Purge	Safely remove all plugin data, records, and analytics
Uninstall	Clean removal with `on_uninstall` lifecycle hook

📊 Health Monitoring & Analytics

Real-time visibility into plugin performance and reliability.

Feature	Description
Health Overview	Traffic-light health scores (🟢 green, 🟡 yellow, 🔴 red) for every plugin
Analytics Dashboard	Page views, unique users, and error counts with 7–90 day time-series charts
Error Trend Analysis	7-day rolling window detects error spikes and patterns
CSV Export	Export analytics data for external analysis
Ask AI Stats	Track queries routed to plugin agents and confidence scores
Dead Letter Queue (DLQ)	View failed event deliveries with payload inspection, retry, or discard
Suspended Handlers	Detect and unsuspend event handlers that failed repeatedly
Audit Log	Complete history of plugin actions: create, update, deploy, rollback, enable, disable

Health Indicators:

🟢 Green — Healthy, no issues
🟡 Yellow — Elevated error rate or suspended handlers
🔴 Red — Failed validation, failed runtime, or quarantined (3+ consecutive failures)

🔄 Version Control & Rollback

Safe version management with data-aware rollback.

Feature	Description
Two-Phase Rollback	Restores previous code version and reports data impact
Rollback Preview	Dry-run mode shows audit log entries affected before committing
Auto-Quarantine	Plugins quarantined after 3 consecutive failures
Failure Recovery	Clear failure status and retry loading
Data Migration	`on_upgrade` hooks run automatically when data version increases

💡 AI Improvement Suggestions

Proactive code analysis with actionable upgrade recommendations.

Feature	Description
Automated Analysis	Scans plugin source code for improvement opportunities
Opportunity Detection	Identifies missing RAG indexes, agent capabilities, widget support, and more
Pattern Checks	Detects N+1 query patterns, missing error handling, and security issues
Score System	Improvement score (0–100) with prioritized suggestions
Import for Review	Import any deployed plugin into the AI Builder for AI-assisted improvements

🔌 Platform Read APIs

Plugins access live platform data through 16+ read-only query objects.

API	Data Available
Users	Employee profiles, roles, departments
Shifts	Shift assignments, times, locations
Schedules	Published schedules and status
Locations	Business locations and metadata
Departments	Organizational structure
Attendance Records	Clock-in/out, hours worked
Timesheets	Timesheet entries and approvals
Leave Requests	Leave types, status, balances
Holidays	Business holiday calendar

🗄️ Plugin Data Storage

Flexible data storage with JSONB records and key-value store.

Feature	Description
JSONB Records	Store structured data with automatic business scoping
Key-Value Store	Simple get/set for plugin configuration and counters
File Attachments	Attach files to records (10MB max, 10 files per record)
RAG Indexing	Opt-in semantic search via pgvector embeddings
Data Versioning	Schema migrations with `on_upgrade` hooks and field helpers

🔗 Capabilities & Integrations

Plugins declare capabilities to access powerful platform services.

Capability	What It Enables
Email	Send formatted emails via `PluginMailer` with ERB templates (100/hour limit)
HTTP	Call external APIs with configurable `allowed_domains` (50 requests/min)
Scheduled Jobs	Cron-like scheduling for recurring tasks
Webhooks	Receive incoming webhooks with HMAC-SHA256 verification and replay prevention
Platform Events	Listen to 25+ events (shift.created, leave_request.approved, schedule.published, etc.)
Dashboard Widgets	Add widgets to the main dashboard via `PluginWidgetAdapter`
Settings Hub	Auto-generated admin settings UI from `setting` DSL
Plugin Interop	Call tools exposed by other deployed plugins
Notifications	Send in-app notifications to users with action buttons
Ask AI Agent	Expose plugin data to the Ask AI assistant for natural language queries

🔐 Security & Validation

Enterprise-grade security built into every layer.

Feature	Description
Static Analysis	Security scan blocks dangerous patterns (eval, system calls, direct DB access)
Ruby Syntax Validation	Catches syntax errors before deployment
File Validation	Structural checks ensure plugin.rb exists and slug is unique
HMAC-SHA256 Webhooks	Incoming webhooks verified with cryptographic signatures
Rate Limiting	Per-plugin, per-business limits for HTTP, email, and geocoding
Request Timeout	Plugin controllers enforce 30-second request timeout
Business Isolation	All data automatically scoped to the current business
Capability Declarations	Sensitive operations require explicit capability opt-in

🔑 MCP API (External Development)

Develop plugins from external tools like Cursor, Claude Code, or CLI.

Feature	Description
API Key Management	Generate, list, and revoke API keys with scoped permissions
Key Scopes	`builder` (build plugins), `query` (read platform data), `manage` (admin operations)
Tool Endpoints	Access SDK docs, example plugins, syntax validation, security scanning, and more
Platform Queries	Read-only access to users, shifts, schedules, and other platform data
Bearer Auth	Keys use `mopk_` prefix with expiration and last-used tracking

🤖 Ask AI Integration

Plugins can expose their data to the conversational Ask AI assistant.

Feature	Description
Agent DSL	Declare plugin agent tools using `agent` DSL in plugin.rb
Tool Discovery	Ask AI automatically discovers and registers plugin tools
RAG Search	Semantic search over plugin records via pgvector embeddings
Audit Logging	All RAG retrievals logged for compliance

📧 Plugin Notifications

Type	Description
Email	Send formatted HTML emails using `PluginMailer` with custom ERB templates
In-App Notifications	Actionable notifications with buttons via `notify_user`
Webhook Events	Outgoing events to external systems

User Roles & Permissions

Role	Capabilities
Admin	Full access: AI Builder, Plugin Manager, Health Monitoring, API Keys, Settings, Deploy, Rollback, Data Purge
Employee	Use deployed plugin apps (as enabled by admin); plugin-specific permissions defined per plugin

How We Compare

See how MangoApps App Builder stacks up against leading enterprise solutions:

Feature	MangoApps App Builder	Microsoft Power Apps	Retool	ServiceNow App Engine
AI-Powered App Generation	✅	⚡ Limited (Copilot)	❌	⚡ Limited
Conversational Building	✅	❌	❌	❌
Pre-Built Templates	✅ (20+)	✅	✅	✅
Platform Data Access	✅ (16+ APIs)	✅ (Dataverse)	✅ (APIs)	✅ (Tables)
Health Monitoring & DLQ	✅	❌	❌	✅
Version Rollback	✅	⚡ Limited	❌	✅
AI Improvement Suggestions	✅	❌	❌	❌
MCP API for External Dev	✅	❌	❌	❌
Unified HR Platform	✅	❌	❌	⚡ Limited
No Per-User Licensing	✅	💰 $20/user/mo	💰 $10+/user/mo	💰 Custom

Legend: ✅ Included	❌ Not Available	💰 Paid Add-on	⚡ Limited

Why MangoApps App Builder?

🤖 AI-Native — The only platform where you describe apps in plain English and AI builds them end-to-end
🔗 Unified Platform — Apps natively access shifts, schedules, attendance, leave, and user data—no API setup required
💰 No Hidden Costs — All capabilities included, no per-user or per-app pricing
🛡️ Enterprise Operations — Health monitoring, rollback, DLQ, and audit logs from day one

Getting Started

For Administrators — AI Builder

Navigate to Admin → App Builder (AI Builder tab)
Choose a template from the gallery or type a description of the app you want
Watch the AI stream progress as it builds your app in real-time
Review the generated files and click Deploy to go live
Access your new app in Apps → your custom app

For Administrators — Plugin Manager

Go to Admin → Plugins to see all installed plugins
Use the toggle to enable or disable plugins for your business
Upload custom plugins via ZIP upload or install from the Marketplace
Monitor performance on the Health tab with analytics and error tracking

For Administrators — MCP API

Open the AI Builder and click API Keys
Generate a new API key with the scopes you need (builder, query, manage)
Use the key in external tools (Cursor, Claude Code) via the /api/plugin-mcp endpoint

Best Practices

Building Plugins

✅ Start with a template — The 20+ templates cover common patterns and demonstrate best practices
✅ Be specific in descriptions — The more detail you give the AI, the better the result
✅ Iterate in the same session — Refine and add features through follow-up messages
✅ Review before deploying — Check the generated files and use the validate button

Managing Plugins

✅ Monitor health regularly — Check the Health dashboard for error trends and performance
✅ Review improvement suggestions — The AI analysis finds optimization opportunities
✅ Use rollback for emergencies — Two-phase rollback restores the previous version safely
✅ Purge data when uninstalling — Clean up plugin records to avoid orphaned data

Security

✅ Review security scans — The AI runs security scans automatically; review any warnings
✅ Use capability declarations — Only grant plugins the capabilities they actually need
✅ Rotate API keys — Revoke unused MCP API keys and set expiration dates
✅ Monitor audit logs — Track who deployed, modified, or rolled back plugins

Frequently Asked Questions

Q: Do I need coding experience to build plugins?
A: No. The AI Builder accepts plain-English descriptions and handles all code generation, validation, and deployment. You can also choose from 20+ templates that cover common use cases like expense tracking, approval workflows, and analytics dashboards.

Q: Can I modify a plugin after it’s deployed?
A: Yes. Import any deployed plugin back into the AI Builder to make changes. You can also manually edit files in the file editor, send follow-up messages to the AI to refine features, or download the source code as a ZIP for external development.

Q: What happens if a plugin causes errors?
A: The platform automatically tracks errors and quarantines plugins after 3 consecutive failures. You can view errors in the Health dashboard, check the Dead Letter Queue for failed events, and rollback to a previous version if needed.

Q: Can plugins access employee shift and attendance data?
A: Yes. Plugins have read-only access to 16+ platform APIs including users, shifts, schedules, attendance records, timesheets, leave requests, and more. All data is automatically scoped to the current business for security.

AI Plugin Builder Deep Dive — Detailed guide to the AI agent, 17 tools, streaming, templates, and build workflow
Apps & Extensions Overview — Complete marketplace app catalog
Workforce Bots Overview — AI Q&A bots and document analysis tools
AI Writer Overview — AI-powered content generation

The App Builder puts the power of custom application development in the hands of every administrator. Describe what you need, and let AI build it.

Was this article helpful?

Article ID: app_builder_app_overview