Onboarding Guide

Preview & Testing

Overview

Before a product is released, it must be thoroughly validated to ensure that all configuration logic, visual output, and manufacturing exports behave as intended. TwikBot provides a built-in Preview environment for this purpose, allowing you to experience the configurator exactly as an end user would — and to export and inspect configuration data before committing to a release.


Using the Preview Environment

The Preview environment is accessible directly from the Products Dashboard via the Preview action on any product. It launches a live view of the configurator in its current state, reflecting all logic and assets defined in the Graph Editor.

In Preview you can:

  • Walk through all configuration paths and verify that options appear and behave as intended

  • Check that the 3D visual output updates correctly for each parameter selection

  • Verify that rules and constraints are working — valid options are available, invalid combinations are blocked or hidden

  • Download export data from specific configurations to inspect and validate manufacturing output


What to Test

A structured approach to testing saves significant time and avoids issues being discovered after release. The following checklist covers the key areas to validate before releasing a product:

Configuration Logic

  • All parameters and parameter groups are present and correctly labelled

  • All options within each parameter are available and display correctly

  • Visibility rules show and hide the correct parameters based on active selections

  • Enable/disable rules correctly restrict unavailable options

  • Dependency rules automatically apply the correct values where expected

  • No invalid combinations can be reached through any configuration path

Visual Output

  • The 3D model updates correctly for every parameter value change

  • Materials and textures render accurately and match the intended appearance

  • Camera angles and scene settings are correctly configured

  • Rendering performance is acceptable on target devices — test on mobile if relevant

  • AR mode functions correctly if in scope for the deployment

Manufacturing Output

  • Download export data for a representative range of configurations

  • Verify that the exported data matches the expected structure and content for each configuration

  • Check that dimension-driven or parametric geometry outputs correctly for products with variable geometry

  • Validate BOM line items against the product specification


Iterating Before Release

Preview is designed to support an iterative build process. Return to the Graph Editor to make changes, then re-enter Preview to verify the result. There is no need to release between iterations — changes in the Graph Editor are reflected immediately in the Preview environment.

Keep a record of issues found during testing and track them to resolution before proceeding to release. This is particularly important on larger products with complex rule sets, where a single logic error can have cascading effects across multiple configuration paths.


Developer Resources

Resource

Location

Product Setup Reference

Products | Setup

Web SDK Reference

Web SDK | Reference