BuildWithHQ PlatformTemplatesSolutionsCalculatorCompare DocsLog inGet started
Tenant-Level Design Forking

Customer-level page forks: deep customization without downstream regressions

BuildWithHQ separates the application engine from each tenant’s page configuration. A SaaS owner can publish a base page for all customers, then allow selected customers to fork that page into a private tenant override with its own JSON, history, version, and adoption state.

How Customer-level page forks fits into BuildWithHQ

BuildWithHQ separates the application engine from each tenant’s page configuration. A SaaS owner can publish a base page for all customers, then allow selected customers to fork that page into a private tenant override with its own JSON, history, version, and adoption state.

Platform relationship: This capability uses the same tenant, record, permission, workflow, logging, AI, and extension architecture as the rest of BuildWithHQ.

Fork creation

Editable base page

The SaaS owner marks which pages may be customized at the tenant level.

Version capture

The fork records the base page version and the exact base JSON from which the customer started.

Private page JSON

The tenant receives an isolated page definition that can be modified without changing other customers.

Single active fork

The platform prevents accidental duplicate active forks for the same tenant and page.

Ongoing base development

Independent base releases

The SaaS owner can continue improving the master page for new and standard customers.

No automatic overwrite

A tenant fork remains stable when a new base version is published.

Change comparison

The platform can compare the old base, new base, and tenant-modified page.

Intentional adoption

A merged page can be applied when the customer chooses to adopt selected upstream improvements.

History and recovery

Previous page snapshot

Before adoption or replacement, the prior tenant page is retained.

Previous fork origin

The earlier base version and base JSON remain available for comparison.

Version increment

Every adopted or edited page advances the tenant page version.

Rollback

History supports returning to a prior tenant state without redeploying the application code.

Commercial value

True white-label differentiation

Agencies can give important customers custom screens and workflows without creating separate code repositories.

Anti-regression guarantee

Core product improvements do not silently break customized customer experiences.

Portfolio scale

One SaaS product can support many tenant variations through configuration rather than branching the application code.

Premium services

Tenant-specific layouts and workflows can become a paid implementation or enterprise-customization offering.