Collections

Bundle multiple packages together

Collections

Collections are curated bundles of packages that work together for specific development workflows.

What are Collections?

Instead of installing packages one by one:

prpm install typescript-strict
prpm install @username/react-best-practices
prpm install tailwind-config
prpm install testing-patterns

You can install a collection:

prpm install collections/my-react-setup

Creating Collections

Collections are defined in your prpm.json using the collections array:

{
  "name": "my-prompts-repo",
  "author": "Your Name",
  "license": "MIT",
  "collections": [
    {
      "id": "react-complete",
      "name": "Complete React Setup",
      "description": "Full React development setup with TypeScript and testing",
      "version": "1.0.0",
      "category": "development",
      "tags": ["react", "typescript", "testing"],
      "packages": [
        {
          "packageId": "typescript-strict",
          "version": "^1.0.0",
          "required": true,
          "reason": "Enforces strict type checking"
        },
        {
          "packageId": "@username/react-best-practices",
          "version": "^2.0.0",
          "required": true
        },
        {
          "packageId": "tailwind-config",
          "version": "^1.5.0",
          "required": false,
          "reason": "Optional Tailwind CSS setup"
        }
      ]
    }
  ]
}

Version Ranges

Specify how packages should be updated:

• ^1.0.0 - Compatible with 1.x.x (recommended)
• ~1.2.0 - Compatible with 1.2.x
• 1.0.0 - Exact version only
• latest - Always use latest version

Required vs Optional Packages

Mark packages as optional so users can skip them:

{
  "packageId": "storybook-setup",
  "version": "^1.0.0",
  "required": false,
  "reason": "Optional Storybook configuration"
}

Install without optional packages:

prpm install collections/react-complete --skip-optional

Publishing Collections

Collections are published alongside packages:

prpm publish

Or publish only a specific collection:

prpm publish --collection react-complete

Use Cases

Starter Kits

Bundle everything needed for new projects:

{
  "id": "nextjs-starter",
  "name": "Next.js Starter",
  "description": "Complete Next.js setup with TypeScript and Tailwind",
  "packages": [...]
}

Team Standards

Share team development standards:

{
  "id": "acme-standards",
  "name": "ACME Corp Standards",
  "description": "Company development standards",
  "packages": [...]
}

Technology Stacks

Bundle complete technology stacks:

{
  "id": "python-ml-stack",
  "name": "Python ML Stack",
  "description": "Machine learning development stack",
  "packages": [...]
}

Next Steps

Publishing Collections

Learn how to publish your collections

Manifest Reference

Complete collection schema