Appearance, Templates & Custom CSS — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Style the storefront COD trigger button and order form in Form Builder → Form Designer (/app/form-builder) so colors, typography, text direction (AUTO, LTR, RTL), button icons, animations, and custom CSS match your brand identity.
Preconditions
Section titled “Preconditions”- You have opened Form Builder → Form Designer (
/app/form-builder).
Numbered Instructions
Section titled “Numbered Instructions”1. Select a Theme Preset & Typography
Section titled “1. Select a Theme Preset & Typography”- In Form Designer (
/app/form-builder), open the Appearance & Templates controls (integrated directly into the Form Designer styling workspace). - Choose a curated visual preset or customize individual tokens:
- Background, surface, border, and primary text colors.
- Font scale, border radius, and input field density.
- Preview your changes in real time in the interactive right-hand live preview pane across desktop and mobile viewports.
2. Configure Text Direction (direction)
Section titled “2. Configure Text Direction (direction)”- Locate the Text Direction (
preferences.direction) setting. - Select one of the three supported values:
AUTO: Automatically adapts to the active storefront document direction.LTR: Forces left-to-right layout (standard for English and Turkish).RTL: Forces right-to-left layout (for Arabic, Hebrew, and RTL storefronts; synchronized with thertlflag).
3. Customize the CTA Button, Icons & Motion Tokens
Section titled “3. Customize the CTA Button, Icons & Motion Tokens”- Select the Submit Button / Buy Button Appearance card (
ButtonAppearance). - Customize the button text (including dynamic total price tokens), background color, text color, and border radius.
- Optionally select:
- Button Icon (
buttonIcon): Choose from the curated vector icon library. - Icon Position (
iconPosition): Place the icon before the label (default) or after (after). - Icon Motion (
iconMotion): Keep the icon static (still) or apply subtle icon motion. - Button Animation (
animation): Choose from the19shared motion tokens (such as pulse, shake, bounce, or shimmer) validated identically bybutton-style.tsandcod-button-style.js.
- Button Icon (
4. Add Sanitized Custom CSS (Optional)
Section titled “4. Add Sanitized Custom CSS (Optional)”- Open the Custom CSS panel in Form Designer.
- Enter scoped CSS rules targeting form classes.
- Click Save in the SaveBar. The server validates and sanitizes custom CSS before projecting it into
cod_form.v2_snapshot.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”Troubleshooting Steps
Section titled “Troubleshooting Steps”- Button animation does not play on the storefront: Check if your operating system or browser has Reduce Motion (
prefers-reduced-motion: reduce) enabled. The storefront stylesheet respects accessibility preferences and suppresses continuous animations when reduced motion is active. - Removed legacy keys (
hideLabels/showIcons): Globalpreferences.hideLabelsandpreferences.showIconswere replaced by per-elementhideLabelandshowIcontoggles on each field in Form Designer.