V2 Marketplace Documentation

V2 marketplaces provide recipe books, path keys, and adapters that transform V2Genome to StandardizedGenome.

Overview

V2 marketplaces:

Transform genomes: V2Genome → StandardizedGenome
Provide recipe books: Package → Module mapping
Define path keys: Semantic path definitions
Implement adapters: Marketplace-specific logic

Core Concepts

Marketplace Adapter Interface - Complete interface reference
Recipe Books - Package → Module mapping
Path Keys - Semantic path definitions
Manifest - Module registry

Marketplace Structure

marketplace/
├── adapter/
│   └── index.js          # Marketplace adapter
├── capabilities/          # Infrastructure modules
├── features/              # Complete features
├── manifest.json          # Module registry (generated)
├── recipe-book.json       # Package → Module mapping (generated)
└── path-keys.json         # Path key definitions

Key Responsibilities

1. Transform Genomes

Marketplaces transform V2Genome to StandardizedGenome:

async transformGenome(genome: V2Genome, options, context) {
  // Use CompositionEngine to resolve
  const handler = new context.V2GenomeHandler(...);
  const lockFile = await handler.resolveGenome(genome);
  return handler.convertLockFileToResolvedGenome(lockFile, genome);
}

2. Provide Recipe Books

Recipe books map business packages to technical modules:

{
  "packages": {
    "auth": {
      "providers": {
        "default": {
          "modules": [
            { "id": "capabilities/auth", "targetPackage": "auth" }
          ]
        }
      }
    }
  }
}

3. Define Path Keys

Path keys define semantic paths:

{
  "pathKeys": [
    {
      "key": "apps.web.root",
      "description": "Web app root directory",
      "computed": true
    }
  ]
}

Creating a Marketplace

Use the CLI command:

architech marketplace generate <name> --type opinionated

This creates:

Directory structure
Adapter with all required methods
Build scripts
Path keys structure

Marketplace Adapter Interface - Complete reference
Creating Your Marketplace - Step-by-step guide
Marketplace-CLI Relationship - How they work together

Path Mapping Generator Marketplace Adapter Interface