GuidesUsing blocks

Using blocks

Blocks are the pieces your pages are built from. This guide is about working with them day to day; for what a block is, see What is a Block?.

Adding blocks

You describe what you want and PhiCo proposes a Receipt — a line-numbered account of every block, property, capability and theme change. Accept the diff and the blocks are applied.

You can also work directly in the canvas: click to select a block, edit its properties in the side panel, or type / to insert a new one from the live catalog.

Customising blocks

Click any block to open its settings. Every property is validated against the block’s own schema, so an invalid value is refused when you set it rather than after publish. Colours and typography come from the app’s theme — reach for a theme value before a hand-written hex, so a later change of appearance carries the whole app with it.

Where new blocks come from

Your World starts with the catalog its plan installs. Beyond that:

  • Marketplace — install blocks and starters we publish.
  • Custom blocks — a team that writes its own blocks packages them as a pwpack, and they install into that team’s own workspaces like any other. Listing them on the marketplace is not open to other teams today.