v2
Marketplace Documentation
Manifest

Manifest

The manifest is the module registry that lists all available modules in a marketplace.

Overview

The manifest:

  • Lists all modules (capabilities, features)
  • Provides module metadata (id, name, description, category)
  • Defines module structure (source, blueprint, templates)
  • Specifies dependencies and parameters

Structure

{
  "version": "1.0.0",
  "generatedAt": "2025-11-22T21:45:31.670Z",
  "stats": {
    "totalModules": 17,
    "capabilities": 17,
    "features": 0
  },
  "modules": {
    "capabilities": [
      {
        "id": "capabilities/ui",
        "name": "UI (Tamagui Universal Design System)",
        "description": "...",
        "category": "infrastructure",
        "type": "capability",
        "version": "1.0.0",
        "source": {
          "root": "capabilities/ui",
          "marketplace": "saas"
        },
        "blueprint": {
          "file": "capabilities/ui/blueprint.ts",
          "runtime": "source"
        },
        "templates": ["..."],
        "dependencies": {
          "required": [],
          "optional": []
        },
        "parameters": {
          "defaults": {},
          "schema": {}
        }
      }
    ],
    "features": []
  }
}

Module Fields

id

Unique module identifier:

{
  "id": "capabilities/ui"
}

Format: {type}/{name} (e.g., capabilities/ui, features/payments)

name

Human-readable name:

{
  "name": "UI (Tamagui Universal Design System)"
}

description

Module description:

{
  "description": "Production-ready universal design system..."
}

category

Module category:

{
  "category": "infrastructure"
}

Categories: infrastructure, framework, database, auth, ui, etc.

type

Module type:

{
  "type": "capability"
}

Types: capability, feature, adapter, connector

source

Module source location:

{
  "source": {
    "root": "capabilities/ui",
    "marketplace": "saas"
  }
}

blueprint

Blueprint file location:

{
  "blueprint": {
    "file": "capabilities/ui/blueprint.ts",
    "runtime": "source"
  }
}

Runtime: source (TypeScript) or compiled (JavaScript)

templates

Template files:

{
  "templates": [
    "capabilities/ui/templates/provider.tsx.tpl",
    "capabilities/ui/templates/components/Button.tsx.tpl"
  ]
}

dependencies

Module dependencies:

{
  "dependencies": {
    "required": ["database"],
    "optional": ["email"]
  }
}

parameters

Module parameters:

{
  "parameters": {
    "defaults": {
      "theme": "light"
    },
    "schema": {
      "theme": {
        "type": "string",
        "enum": ["light", "dark"]
      }
    }
  }
}

Module Types

Capabilities

Infrastructure modules:

{
  "modules": {
    "capabilities": [
      { "id": "capabilities/ui", ... },
      { "id": "capabilities/auth", ... }
    ]
  }
}

Features

Complete features:

{
  "modules": {
    "features": [
      { "id": "features/payments", ... },
      { "id": "features/teams", ... }
    ]
  }
}

Manifest Generation

Manifests are generated from module schema.json files:

npm run build:manifest

Process:

  1. Scan capabilities/ and features/ directories
  2. Read schema.json from each module
  3. Generate manifest with all modules

Related