Bottom Navigation Bar

Before you start

• Two to five primary destinations
• Short labels and stable URLs

Configure and verify

1. Enable and style

   Set theme backgrounds, normal colors, selected item colors, height, icon size, and title size.

2. Create items

   Choose an icon, enter a label and action URL, add items, and drag them into order.

3. Configure long press

   Optionally let a long press replace the preferred home URL and show a confirmation snackbar.

4. Set visibility

   Hide navigation on checkout, full-screen media, or pages where it covers controls.

5. Test selection

   The selected background fills the complete item section in the APK. Verify selected and unselected colors stay distinct.

Design guidance

• Use three to five destinations.
• Keep labels short.
• Use familiar icons.
• Do not use identical foreground and background colors.

Runtime updates

Website JavaScript can replace items and selected state for the current session through update_settings.

Test before release

• Every destination loads
• Selected state is clear
• Labels fit
• Website controls remain reachable
• Order matches the editor