Real-World Scenario: Store Personalization

In this step, your App asks the Merchant to define their niche so you can pre-configure the App's layout. We will validate two fields: business_category (Dropdown) and primary_goal (Radio/Selection).

The Validation Logic

Selection Requirement

Ensure the merchant has selected a category from the list.

Logic Constraint

If they select "Other" as a category, you might require them to provide additional details. (For this minimal example, we will ensure they at least make a primary selection.)

Implementation Example

Field Key	UX Purpose	Validation Focus
`business_category`	Allows the app to load industry-specific templates (e.g., Food vs. Fashion).	Presence check (Ensures the value is not empty).
`primary_goal`	Determines which metrics (ROI, Conversion, or Traffic) appear on the home screen.	Data integrity (Ensures the value matches your accepted list).

Important

Contextual Feedback

By using .setFields(), the error message appears directly under the Business Category dropdown, ensuring the merchant notices and corrects it.

Immediate Value

The success() block triggers a personalized dashboard. This creates an "Aha!" moment for the merchant and reinforces the value of completing onboarding.

Real-World Scenario: Store Personalization

The Validation Logic#

Implementation Example#

The Validation Logic

Implementation Example