Nuuly Web Swap Reminder

WHAT IT DOES

This tool monitors your Nuuly clothing rental subscription and keeps you informed about your swap window, current items, and billing cycle. It extracts subscription data including current rented items, return dates, swap window dates, and upcoming billing dates from the page. The panel displays a live countdown timer to the next swap window, color-coded to show urgency—green when the window is approaching, yellow for warning, and blue when the swap is open. A list shows all current rented items with their status (rented, shipped, returned). The script also tracks your billing cycle and shows days until the next charge, helping you plan your wardrobe swaps and avoid surprises.

WHERE IT RUNS

The script activates on Nuuly pages (nuuly.com), including the account dashboard, wardrobe view, subscription settings, and order history pages. It automatically detects subscription data using multiple extraction strategies that work across different Nuuly layouts. The panel appears as a draggable overlay that stays accessible as you manage your subscription.

HOW TO USE

Navigate to your Nuuly account page. The panel will appear showing the countdown to your next swap window, a summary of your subscription items, and billing information. Set the "Remind (days)" input to control how many days before the swap window you receive a notification (default 3 days). Toggle "Notify on/off" to enable or disable desktop notifications when the swap window approaches. The "Refresh" button manually updates the data, and "Reset Notification" clears the notification flag so you can test reminders. The panel updates automatically every minute to keep the countdown current.

THE TECHNICAL MECHANISM

The script employs a multi-strategy DOM extraction approach for Nuuly's dynamic subscription interface. It first attempts structured selectors targeting known class names like .rental-item, .item-card, and .wardrobe-item, then falls back to heuristic detection of item containers based on content patterns including size, color, and brand indicators. Swap window dates are extracted from text patterns matching "swap window", "swap date", or "swap opens". Return dates are identified from patterns like "return by" or "return date", and billing dates from "billing date", "billing cycle", or "next billing". Item status detection uses pattern matching for "rented", "returned", and "shipped" indicators. The countdown timer uses setInterval with 1-minute granularity, computing the difference between the current time and the swap window date. The notification system uses GM_notification with a storage-based deduplication system using GM_setValue to prevent repeated reminders. The notification flag is automatically cleared when the swap window opens or when the reminder lead time is exceeded, ensuring accurate reminders. All settings are persisted using GM_setValue.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Nuuly may update its site structure, which could affect the script's ability to detect subscription data — updates will be released as needed. All subscription data is read from the page and displayed locally; nothing is transmitted externally. This tool is for informational purposes only and does not replace official Nuuly notifications. The script does not modify your Nuuly account or subscription in any way. Always verify swap dates and billing information with the official Nuuly platform.