メインコンテンツへスキップ

ARC 2.0.0-beta.25

Build a first AUP app

Use the minimal-app recipe for a verified ARC AUP starting path.

This path uses minimal-app because the current CLI explicitly provides it and can explain its sources, generated artifacts, and checks. It creates a complete slice rather than pretending to be a pure-AUP app.

Inspect the recipe boundary first

bash
arc blocklet recipe explain minimal-app

On 2.0.0-beta.25, the output identifies web, aup, agent, and settings capabilities, and lists source DSL, AFS data, compatible artifacts, and the profile check.

Create the app

bash
arc blocklet create ./hello-aup --recipe minimal-app --name hello-aup

In this page's verification, the CLI confirmed 18 created files and printed a next validation command using the resolved absolute path of the created directory. That absolute path depends on where you create the project, so do not treat it as tutorial syntax.

text
Created minimal app blocklet "hello-aup" with 18 file(s).

After creation, read these sources instead of editing generated artifacts:

FileRole
.aup/app.aupDSL source for the AUP app
pages/index/layout.aupDSL source for the Web page layout
.web/components/app-hero/component.dslDSL source for the site-component manifest
agents/app-agent/agent.dslDSL source for the agent manifest
seed/settings/.../settings.aupSettings source

The recipe also writes some JSON compatibility artifacts, but it does not materialize .aup/app.json, .aup/pages/*.json, or .aup/wrapper.json in advance. If a consumer explicitly needs them, read Generate, lint, and migrate; do not hand-edit them when no consumer needs them.

Continue to Validate, run, and inspect.