Published Versions

Every time you press Publish in the builder, the platform captures the current saved Working Copy as a numbered, immutable snapshot and adds it to the Published Versions list. The newest entry is what users see at the Application URL.

The Versions Tab

Navigate to the app detail page and open the Versions tab to see the full published history, listed newest first. Until the application has been published at least once, the tab displays:

Versions Tab Columns

Steps: Viewing a Past Version

1. Open the app detail page and click the Versions tab.

2. Click the version row you want to inspect. The version opens in a read-only view labelled V{n} | Created on {date}.

3. Use the page switcher inside the read-only view to navigate between pages of that historical release. No changes can be made from this view — it is for inspection only.

4. Close the view or navigate back to the Versions tab when finished.

Steps: Restoring a Published Version

1. In the Versions tab, click the version you want to restore.

2. Click Restore this version. A confirmation dialog appears with the message: "Don't worry — your live app won't be affected until you publish."

3. Confirm the restore. The platform shows "Application restored successfully."

4. The builder reloads with the restored Working Copy. Open Preview to verify the result before shipping it.

5. When ready, click Publish. The platform creates the next sequential version number with the restored version's content — version numbers never rewind.

Note: Restoring sets up the rollback; publishing ships it. You are always safe to restore and review in Preview before committing to a publish. The live application is untouched until you explicitly publish the restored state.

Publishing from the Builder

When you publish from inside the builder, the current saved Working Copy becomes a new entry in the Published Versions list with optional metadata you supply at publish time.

• Version tag — A short identifier (must start with a letter; no spaces; only - and _ allowed as special characters). Displayed alongside the version number in the Versions tab.

• Version notes — Free-text changelog entry. Treat these as a commit message: describe what changed and why, so teammates can read the list as a release history.

• Changes since last published — A per-area summary (Application, Pages, Modules, Walkthroughs, Icons) with addition and removal counts. Click any row to navigate to that area; use Review all changes to see the full diff.

If no new saves have been made since the last publish, the dialog shows "Up to date with V{n} — No changes since the last published version." Publishing in this state does not create a new version number.

Saved Versions

Saved Versions are a fine-grained, automatically generated edit history maintained inside the builder. Every Save action — whether triggered manually or automatically — creates a new entry. You never need to name or create a saved version; the platform does it for you.

Note: Versions are auto-captured — you cannot manually name or create one. Each entry in the Saved Versions panel reflects the exact application state at the moment of a save. The list grows continuously as you work.

The Saved Versions Panel

Open the Saved Versions panel from the builder's left rail. Until the application has been saved at least once, the panel displays:

Saved Version Entry Fields

Filtering Saved Versions

The panel provides filters to narrow the list:

• Scope — Filter by App (all application-level saves) or Page (saves for a specific page; a page picker appears when Page is selected).

• Version — Show All entries, only Saved entries, or only Published entries (those with a Deployed V# badge).

• Author — Filter to saves made by a specific team member.

• Clear all / Apply — Reset filters or apply the current selection.

Steps: Restoring from Saved Versions

1. Open the Saved Versions panel from the builder's left rail.

2. Use filters (Scope, Version, Author) to locate the entry you want to restore.

3. Click Restore on the target entry. A confirmation modal opens, naming the save date, the impact of the restore, and whether it is app-scoped or page-scoped.

   • App-scoped entry — Reverts the entire application's Working Copy: all pages, data sources, and settings.

   • Page-scoped entry — Reverts only the selected page; the rest of the application is untouched.

4. Confirm the restore. The builder reloads with the restored state. Any collaborators currently in the builder are prompted to reload.

5. Verify the result in Preview, then publish when ready to ship the rolled-back state to users.

Note: Restoring a collaboratively-edited app prompts all editors to reload. Any unsaved work by collaborators in the builder at the moment of the restore will be lost. Coordinate with your team before restoring in a shared editing session.

Creating a New App from a Saved Version

If you want to salvage a historical state without overwriting the current Working Copy, the Saved Versions panel offers an option to create a new application from any entry. The new app is an independent copy frozen at that historical state; editing it does not affect the original.

Comparing Versions

The Compare Versions view gives a diff-style breakdown of what changed between any two points in the application's history, including the live current edits.

Steps: Comparing Two Versions

1. Open the publish dialog and locate the "Compare any two versions or your current edits with a published version" link. Alternatively, select two entries in the Saved Versions panel and use the compare action.

2. Set the Base version (the older point) and the Compare version (the newer point) using the pickers. Options include all published versions, "Current edits", and "Last published".

3. Browse changes grouped by area: Application, Pages, Modules, Walkthroughs, Icons.

4. Within a page, changes are further broken down by: Page config, Blocks, Variables, Functions, Data sources, Steps, Translations, and App config. Deleted pages are marked Deleted page.

5. Adjust the view using the controls:

   • Split vs. Unified — side-by-side or inline diff.

   • Show context only vs. Show all lines — focus on deltas or see the full config.

   • Extracted vs. Raw — human-readable structured view or raw serialized config.

   • Breakpoint filter — Desktop, Tablet, or Mobile.

6. Click Open in Builder on any change row to jump directly to that area in the builder.

Note: Deleted items cannot be previewed — restore the version to see the deleted page. If a page was deleted between the two compared versions, the comparison panel marks it as Deleted page but clicking Preview falls back to the default page. Restore the version to make the deleted page accessible again.

Key Concepts at a Glance