Production Checklist and Troubleshooting

Pre-release checklist

Integration

• Required routes available and protected.
• Bootstrap payload loads in all contexts.
• Save and render paths verified.

Content safety

• JSON payload validation in place.
• Render fallback strategy for unknown/missing modules.
• Preview token TTL and signed URL TTL aligned with security requirements.

Performance

• Rendered HTML/CSS cached per revision.
• CDN/static strategy for public assets established.
• Large gallery/media payloads paginated.

Extensibility

• Custom modules and PropTypes registered deterministically.
• No duplicate type keys.
• No breaking changes to existing module IDs.

Troubleshooting flow

1) Module missing in builder picker

Check:

• context filtering
• module registration
• bootstrap payload availableComponents

2) Styles missing in preview

Check:

• PropType hasCss() and toCss()
• stored prop shape
• stylesheet/render endpoint response

3) Save works but frontend page is outdated

Check:

• whether rendered artifacts are regenerated after save
• cache invalidation policy
• queue delays (if render is async)

4) Form module renders incorrectly

Check:

• toSchema() mapping
• validation tab shape
• field type compatibility

Recommended QA matrix

Run smoke tests at least for:

• page default variant
• page carousel variant
• form context
• mail context
• pdf context

And test one custom module and one custom PropType per release.