ConceptsPacks & the marketplace

Packs & the marketplace

A pack is a bundle of building material for apps. One pack can hold:

  • Blocks — the typed pieces of a page.
  • Capabilities — what lets a page keep data, move between pages and react to visitors.
  • Patterns — ready arrangements of blocks, such as a page shell with a top menu, a contact form or a card grid. The agent copies a pattern into a page and fills in its content.
  • Themes — colour, font and spacing sets for the whole app.

The agent builds only from packs. It does not invent blocks on the fly, so what it puts on a page is something the app can actually draw.

Three places a pack goes through

  1. The marketplace. Packs are listed in the marketplace in your PhiWebs account (account.phiwebs.com → Marketplace). You can search, filter by category, read reviews and install.
  2. Your workspace. Installing a pack makes it available to every project in the workspace. A project can only use what its workspace has installed.
  3. A project. Each project records the packs it uses, at fixed versions, in its pwpack.json. A pack installed in the workspace is not in a project until it is added there.

Every project starts with foundation

A new project starts with the foundation pack only. Foundation carries the everyday blocks, the core capabilities, page shells and other patterns, and a set of themes.

When your app needs something foundation does not have — a chart, a carousel, a pricing band — the agent looks through the packs your workspace has installed and adds the one it needs, together with any packs that one depends on. It adds a pack only when it will use it.

You can also add a pack yourself in the studio’s Packs panel. It shows the packs the project uses and the workspace packs you can add with one click. If you just installed something in the marketplace, press Check for new packs to see it.

If what you ask for cannot be built with the installed packs, the agent says so rather than faking it. Install a pack that has it, then ask again.

Publishing your own pack

You can make your own blocks and patterns and offer them in the marketplace:

  1. Register as a publisher in the marketplace (Become a publisher).
  2. Write and package the pack. The PhiCo Code plugin for Claude Code has the tools to scaffold, package and upload it.
  3. Submit a listing. Listings are reviewed before they appear in the marketplace for other workspaces.

Your own packs can be installed in your workspace and used in your projects like any other pack.

See also