Skip to content

matlab/matlab-agentic-toolkit / skills-catalog/matlab-app-building/matlab-build-app

matlab-build-app

Unverified

Build MATLAB apps from requirements to working code. Asks discovery questions (or skips them when the path is known), recommends UIFigure or UIHTML architecture, identifies layout archetype (Dashboard, Explorer, Tabbed, Wizard, Canvas), produces an implementation plan, and executes the build. For UIFigure apps, optionally serializes as App Designer (.mlapp or plain-text .m + .xml). Use when a user wants to build a MATLAB app, create a GUI, make an interactive tool, build a uifigure app, build a uihtml app, build an App Designer app, build a .mlapp app, build a plain-text App Designer app, or asks which approach to use. Also use when user describes spatial layout needs: dashboard, control panel, sidebar, tabs, wizard, stepper, canvas, workspace.

FileKindSize
SKILL.mdskill md20.9 KB
assets/colors_and_type.cssother12.8 KB
assets/minimal-bridge.htmlother1.3 KB
assets/minimal-bridge.mother1.2 KB
assets/standalone-chart-template.htmlother11.5 KB
manifest.yamlconfig672 B
references/app-designer/agent-guide-mlapp.mdmarkdown15.7 KB
references/app-designer/agent-guide-plaintext.mdmarkdown14.7 KB
references/app-designer/agent-guide-shared.mdmarkdown27.1 KB
references/app-designer/background-tasks.mdmarkdown4.8 KB
references/app-designer/plaintext/classdef-template.mdmarkdown11.3 KB
references/app-designer/plaintext/matlabAppSchema.xsdother16.8 KB
references/app-designer/plaintext/property-reference.mdmarkdown45.1 KB
references/app-designer/plaintext/xml-template.mdmarkdown12.3 KB
references/archetypes/canvas.mdmarkdown8.0 KB
references/archetypes/dashboard.mdmarkdown6.4 KB
references/archetypes/explorer.mdmarkdown5.7 KB
references/archetypes/tabbed.mdmarkdown6.6 KB
references/archetypes/wizard.mdmarkdown9.7 KB
references/background-tasks.mdmarkdown6.9 KB
references/editing-guide.mdmarkdown3.3 KB
references/timers.mdmarkdown2.1 KB
references/uifigure/callbacks.mdmarkdown3.0 KB
references/uifigure/components.mdmarkdown1.7 KB
references/uifigure/containers.mdmarkdown1.3 KB
references/uifigure/grid-layout.mdmarkdown4.9 KB
references/uifigure/guide.mdmarkdown5.3 KB
references/uifigure/layout-patterns.mdmarkdown1.5 KB
references/uifigure/mvvm-background-tasks.mdmarkdown3.9 KB
references/uifigure/mvvm-guide.mdmarkdown11.1 KB
references/uifigure/mvvm-testing.mdmarkdown2.8 KB
references/uifigure/mvvm-view-binding.mdmarkdown5.4 KB
references/uihtml/brand-design-tokens.mdmarkdown5.6 KB
references/uihtml/bridge-guide.mdmarkdown7.0 KB
references/uihtml/chart-bridge-integration.mdmarkdown7.5 KB
references/uihtml/chart-performance.mdmarkdown5.0 KB
references/uihtml/chart-type-selection.mdmarkdown3.1 KB
references/uihtml/chart-updates.mdmarkdown4.7 KB
references/uihtml/charting-guide.mdmarkdown3.9 KB
references/uihtml/chartjs-setup.mdmarkdown4.0 KB
references/uihtml/communication-patterns.mdmarkdown4.2 KB
references/uihtml/component-styles.mdmarkdown4.3 KB
references/uihtml/css-layout-patterns.mdmarkdown5.0 KB
references/uihtml/dark-mode.mdmarkdown3.8 KB
references/uihtml/data-types.mdmarkdown2.7 KB
references/uihtml/doughnut-scatter-charts.mdmarkdown6.0 KB
references/uihtml/error-handling.mdmarkdown4.6 KB
references/uihtml/external-color-schemes.mdmarkdown2.6 KB
references/uihtml/js-coding-guide.mdmarkdown11.2 KB
references/uihtml/js-testing-debugging.mdmarkdown2.9 KB
references/uihtml/line-bar-charts.mdmarkdown5.2 KB
references/uihtml/mvvm-guide.mdmarkdown11.0 KB
references/uihtml/mvvm-observable-classes.mdmarkdown2.9 KB
references/uihtml/mvvm-view-binding.mdmarkdown5.3 KB
references/uihtml/platform-limitations.mdmarkdown2.5 KB
references/uihtml/setup.mdmarkdown3.9 KB
references/uihtml/styling-guide.mdmarkdown8.1 KB
scripts/+module/+backgroundtask/BackgroundTaskModule.pbinary2.5 KB
scripts/+module/+backgroundtask/templates/cancelBackground.mother357 B
scripts/+module/+backgroundtask/templates/handleBackgroundComplete.mother1.4 KB
scripts/+module/+backgroundtask/templates/safeProgress.mother734 B
scripts/+module/+backgroundtask/templates/startBackground.mother1.2 KB
scripts/+module/AppBuilderModule.pbinary242 B
scripts/AppDesignerAgentInterface.pbinary12.6 KB
scripts/MlappBackend.pbinary9.4 KB
scripts/PlainTextBackend.pbinary10.2 KB

references/uihtml/error-handling.md

View on GitHub
# Error Handling Guide

Errors must be caught on both sides of the bridge. An unhandled error on either side breaks the communication chain silently.

## MATLAB Side: try-catch in Every Handler

Wrap the entire event handler body in try-catch and always send the error back to JS:

```matlab
function handleEvent(src, event)
    eventName = event.HTMLEventName;
    eventData = event.HTMLEventData;

    try
        switch eventName
            case 'processData'
                result = processData(eventData);
                sendEventToHTMLSource(src, 'Result', result);

            case 'exportFile'
                exportData(eventData);
                sendEventToHTMLSource(src, 'exportDone', 'ok');

            otherwise
                warning('uihtml:unknownEvent', 'Unknown event: %s', eventName);
        end

    catch ME
        fprintf('[uihtml] Error in %s: %s\n', eventName, ME.message);
        sendEventToHTMLSource(src, 'error', struct( ...
            'event',   eventName, ...
            'message', ME.message));
    end
end
```

Key points:
- Log to the MATLAB command window with `fprintf` — aids debugging without interrupting the app
- Send a structured error object so JS knows which event caused the failure
- The `otherwise` branch with `warning` prevents unknown events from silently doing nothing

## JavaScript Side: Error Event Listener

Always register an `Error` listener in `setup()`. Without it, MATLAB errors are invisible to the user:

```javascript
// Inside setup()
htmlComponent.addEventListener('error', function(event) {
    const err = event.Data;

    if (err && err.event) {
        console.error('[MATLAB] Error in ' + err.event + ': ' + err.message);
        showUserError('Error processing ' + err.event + ': ' + err.message);
    } else {
        console.error('[MATLAB] Error:', err);
        showUserError(String(err));
    }

    setLoading(false); // Always clear loading state on error
});
```

Wrap all MATLAB-event callbacks in try-catch on the JS side too:

```javascript
htmlComponent.addEventListener('resultReady', function(event) {
    try {
        const result = event.Data;
        updateDisplay(result);
    } catch (err) {
        console.error('Error handling result-ready:', err);
        showUserError('Failed to display result');
    } finally {
        setLoading(false);
    }
});
```

## Input Validation at the Bridge Boundary

Validate all data arriving from JavaScript before using it in MATLAB:

```matlab
function result = validateAndProcess(eventData)
    % Check required fields exist
    requiredFields = ["frequency", "amplitude", "plotType"];
    for f = requiredFields
        if ~isfield(eventData, f)
            error('uihtml:missingField', 'Missing required field: %s', f);
        end
    end

    % Cast and validate types
    freq     = double(eventData.frequency);
    amp      = double(eventData.amplitude);
    plotType = char(eventData.plotType);

    if ~isfinite(freq) || freq <= 0 || freq > 100
        error('uihtml:invalidValue', 'Frequency must be between 0 and 100; got %g', freq);
    end

    if ~ismember(plotType, {'sine', 'cosine', 'both'})
        error('uihtml:invalidValue', 'Invalid plot type: %s', plotType);
    end

    result = struct('frequency', freq, 'amplitude', amp, 'plotType', plotType);
end
```

**Validation rules:**
- Always cast JS values to the expected MATLAB type (`double()`, `char()`, `logical()`)
- Check `isfinite()` for numeric values — JS can send `NaN` or `Infinity`
- Validate string values against an allowed list with `ismember()`
- Use descriptive error IDs: `error('uihtml:tag', 'message %s', value)` — these propagate to the JS `Error` listener automatically via the try-catch wrapper

## JS-Side Input Validation

Validate on the JS side before sending — faster feedback, fewer MATLAB round trips:

```javascript
function onSubmit() {
    const freq = parseFloat(document.getElementById('freq').value);
    const amp  = parseFloat(document.getElementById('amp').value);
    const type = document.getElementById('plotType').value;

    if (!Number.isFinite(freq) || freq <= 0) {
        showUserError('Frequency must be a positive number');
        return;
    }

    if (!Number.isFinite(amp) || amp <= 0) {
        showUserError('Amplitude must be a positive number');
        return;
    }

    setLoading(true);
    window.htmlComponent.sendEventToMATLAB('updatePlot', {
        frequency: freq,
        amplitude: amp,
        plotType:  type
    });
}
```

**Both-sides validation is the correct pattern:** JS catches obvious user errors fast; MATLAB validates at the security and correctness boundary.

----

Copyright 2026 The MathWorks, Inc.

----
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall