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/setup.md

View on GitHub
# Setup Guide

Comprehensive setup reference for the MATLAB and JavaScript sides of a uihtml app, plus hybrid layout patterns.

## MATLAB: Creating the uihtml Component

### Full-Figure uihtml (most common)

Use a 1×1 grid with zero padding to fill the entire figure:

```matlab
function app()
    fig = uifigure('Name', 'My App', 'Position', [100 100 800 600]);
    gl = uigridlayout(fig, [1 1]);
    gl.Padding = [0 0 0 0];

    h = uihtml(gl);
    h.HTMLSource = fullfile(fileparts(mfilename('fullpath')), 'app.html');
    h.HTMLEventReceivedFcn = @(src, event) handleEvent(src, event);
end
```

**Always use `fullfile(fileparts(mfilename('fullpath')), ...)` to resolve the HTML path.** This ensures the path is correct regardless of the current working directory when the function is called.

### Partial-Figure uihtml

To place uihtml in one region of a multi-component figure:

```matlab
gl = uigridlayout(fig, [1 2]);
gl.ColumnWidth = {'1x', 300};

h = uihtml(gl);
h.Layout.Column = 1;
h.HTMLSource = fullfile(fileparts(mfilename('fullpath')), 'app.html');
h.HTMLEventReceivedFcn = @(src, event) handleEvent(src, event);
```

### Passing Initial Data

Set `h.Data` after assigning `HTMLSource`. The JS side reads it in the `DataChanged` listener:

```matlab
h.HTMLSource = fullfile(fileparts(mfilename('fullpath')), 'app.html');
h.Data = struct('config', struct('maxPoints', 100, 'unit', 'Hz'));
```

## JavaScript: The setup() Function

Every uihtml HTML file MUST implement a global `setup(htmlComponent)` function. uihtml calls it automatically once the component is ready.

```javascript
function setup(htmlComponent) {
    // 1. Store reference globally for use in other functions
    window.htmlComponent = htmlComponent;

    // 2. Register DataChanged listener if using h.Data
    htmlComponent.addEventListener('DataChanged', function(event) {
        const data = htmlComponent.Data;
        initializeUI(data);
    });

    // 3. Register listeners for custom events from MATLAB
    htmlComponent.addEventListener('resultReady', function(event) {
        displayResult(event.Data);
    });

    // 4. Always register an Error listener
    htmlComponent.addEventListener('error', function(event) {
        console.error('MATLAB error:', event.Data);
        showUserError(event.Data);
    });

    // 5. Trigger initial data load if needed
    requestInitialData();
}
```

**Rules:**
- The function must be named exactly `setup` and be in the global scope (not inside a module)
- If using ES modules, assign it explicitly: `window.setup = function(htmlComponent) { ... }`
- All `addEventListener` calls must happen inside `setup()` or after it has been called

## Hybrid Layout: uihtml + Native MATLAB Components

A uihtml component can coexist with native MATLAB UI components in the same figure:

```matlab
function hybridApp()
    fig = uifigure('Name', 'Hybrid App', 'Position', [100 100 900 600]);
    gl = uigridlayout(fig, [2 1]);
    gl.RowHeight = {'1x', 200};
    gl.RowSpacing = 0;
    gl.Padding = [0 0 0 0];

    % Web frontend in the top area
    h = uihtml(gl);
    h.Layout.Row = 1;
    h.HTMLSource = fullfile(fileparts(mfilename('fullpath')), 'controls.html');
    h.HTMLEventReceivedFcn = @(src, event) handleEvent(src, event, ax);

    % MATLAB axes in the bottom area
    ax = uiaxes(gl);
    ax.Layout.Row = 2;
    title(ax, 'MATLAB Plot');
    grid(ax, 'on');
end

function handleEvent(src, event, ax)
    try
        switch event.HTMLEventName
            case 'updatePlot'
                x = 0:0.01:2*pi;
                y = sin(event.HTMLEventData.freq * x);
                plot(ax, x, y, 'LineWidth', 1.5);
        end
    catch ME
        sendEventToHTMLSource(src, 'error', ME.message);
    end
end
```

**When to use hybrid layout:** web controls are better for complex forms or styled widgets; MATLAB axes are needed for full MATLAB graphics capability. Pass the `ax` handle to the event handler via a closure or `fig.UserData`.

----

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: 321kUpdated 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