Skip to main content

Task recipe · ARC 2.0.0-beta.28

Recipe: first site

Compose a minimal Web Device site by chaining verified getting-started steps with layout and AUP unit pages — no API re-documentation.

Task: ship a local static site with one home route and one named page. This page only orders existing unit and guide pages. It does not redefine component, primitive, or Markdown contracts.

Outcome

  • .route/web + .web/site.yaml + at least one pages/<name>/layout.aup
  • One theme or site layout component on the page
  • Local check + browser open of the printed URL
  1. Install and confirm CLI version: Install ARC CLI.
  2. Confirm this is a static Web Device site (not an interactive AUP app): Requirements and scope.
  3. Create the verified minimal file set: Build a first site.
  4. Run lint / validate / check / build, then open the URL the CLI prints: Run, check, and inspect.

Canonical units you will touch

Role on this pathUnit page (contract lives there)
Page shell / sectionspage-stack · page-sections
Site chrome (optional later)portal-header · portal-footer
AUP container (if you put a document tree on the page)view · text · action

Layout composition rules (not unit APIs): Compose pages and layouts · AUP layout boundary.

Do not do here

  • Do not invent props for layout components — read the unit page for that name.
  • Do not paste article bodies into layout.aup and call it a content site — use Recipe: collection list page next.
  • Do not deploy to DID Space for first acceptance.

Next recipes