Working with surfaces

Surfaces are the pages inside an app. This guide covers the day-to-day work once one exists.

Surface basics

A surface is a single composable page. It is materialised from an accepted Receipt that names every block, property, capability and theme value. Each time you change it, PhiCo proposes a new Receipt; nothing publishes until you accept the diff.

Surface properties

Each surface has:

• Title — the page title shown in browser tabs
• Slug — the path the page answers on inside the app
• Description — the summary search engines and link previews use
• Thumbnail — the preview image for sharing

Duplicating

Duplicate a surface when you want a variation without risking the original — the copy is a new surface with its own history from that point on.

Version history

Every accepted Receipt is a snapshot. Open the version history to roll back to a previous one, or to diff two of them line by line.

How far back the history reaches depends on your plan: Basic keeps no history, Pro 7 days, Team 30 days, Enterprise 90 days.

Next

• Using blocks — what the pages are built from
• Publishing your app — putting them in front of people