deco-apps-architecture

Architect Deco app ecosystems with a shared app pattern and file organization.

5|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/decocms/deco-start --skill deco-apps-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deco-apps-architecture
Source: https://github.com/decocms/deco-start/tree/main/.cursor/skills/deco-apps-architecture
Command: npx skills add https://github.com/decocms/deco-start --skill deco-apps-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture reference for Deco apps monorepo — the canonical library of Deco integrations. Covers the monorepo structure, the app pattern (mod.ts, manifest.gen.ts, actions/loaders/hooks, etc.), and the relationship between deco-cx/apps (Fresh/Deno) and @decocms/apps-start (TanStack/Node). Use when designing new Deco integrations or porting apps to TanStack Start.

Core Features & Use Cases

  • Comprehensive monorepo blueprint for Deco app ecosystems with a unified app pattern.
  • Defines the standard app structure (mod.ts, manifest.gen.ts, runtime.ts, middleware.ts, actions, loaders, hooks, sections, handlers, components, utils, workflows, preview).
  • Illustrates relationships between Deco ecosystem layers and apps-start, plus codegen steps and tooling guidance for initialization and porting.

Quick Start

Review the architecture docs to understand the standard app layout and then run deno task start to generate manifests for your Deco app.

Frequently Asked Questions about deco-apps-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the standard file structure for a Deco app integration?

The standard Deco app structure enforces specific files like mod.ts, manifest.gen.ts, runtime.ts, and middleware.ts, alongside directories for actions, loaders, hooks, and sections to ensure predictable maintenance.

How do I port a Deco integration to apps-start?

To port a Deco integration to apps-start, review the architecture docs to understand the relationship between deco-cx/apps and @decocms/apps-start, then run deno task start to generate manifests.

Can I use the Deco monorepo pattern for Shopify and VTEX integrations?

Yes, the Deco monorepo pattern targets developers creating VTEX, Shopify, Wake, and Nuvemshop integrations by codifying a shared app pattern for consistent app factories and block registries.

What is the difference between deco-cx/apps and @decocms/apps-start?

deco-cx/apps represents the Fresh/Deno ecosystem layer, while @decocms/apps-start represents the TanStack/Node layer, with the architecture defining their relationships and codegen steps for porting.

How do I generate manifests for a Deco app?

You generate manifests for a Deco app by running the deno task start command after reviewing the architecture docs to understand the standard app layout and codegen steps.