📚 HOW TO USE
Welcome! This plugin will save you thousands of Workload Units (WU) by processing, filtering, sorting, and calculating your data at lightning speed directly in the user's browser.

=== 1. INITIAL SETUP ===

👉 Drag the "Data Engine" element onto your page. It is completely invisible to your end-users.
👉 TYPE OF DATA: Select the exact type of data you are processing (e.g., your database table "Products", or an external API response).
👉 DATA SOURCE: Insert your dynamic list here (e.g., "Search for Products" or "Get data from an external API").

=== 2. HOW TO FILTER DATA ===

👉 PROPERTY TO FILTER: Type the exact API ID/Name of the column you want to filter (e.g., category, status).
👉 OPERATOR: Choose your rule from your dynamic setup (contains, equals, greater_than, less_than, not_equals).
👉 VALUE TO MATCH: Type the dynamic value you are looking for.
💡 PRO TIP 1: Text filtering using the "contains" operator is automatically case-insensitive!
📅 PRO TIP 2 (DATES): To filter by Dates perfectly and avoid timezone bugs, ALWAYS pass your dates as UNIX Timestamps. Example: `Date Picker's value: extract UNIX`.

=== 3. HOW TO SORT DATA (SMART SORT) ===

👉 PROPERTY TO SORT: Type the exact API ID/Name of the column you want to order by (e.g., price, title).
👉 SORT DESCENDING?: Choose 'yes' for Z-A / Highest-to-Lowest, or leave empty/'no' for A-Z / Lowest-to-Highest.
⚡ The engine uses Smart Sorting: it natively understands and perfectly sorts dates (timestamps), numbers, text, and alphanumeric values (e.g., "Item 10" will correctly appear after "Item 2").

=== 4. HOW TO CALCULATE SUM & AVERAGE ===

👉 SUM/AVG FIELD: Type the exact API ID/Name of the numeric column you want to calculate (e.g., price, amount).
If left empty, it will automatically try to use your "Property to filter" for the math.

=== 5. DISPLAYING THE RESULTS (ZERO REGEX!) ===

Because our engine outputs fully typed data natively, setting up your UI is pure magic:

1. Set your Repeating Group's "Type of content" to match your "Type of Data".
2. Set its "Data Source" to the plugin's exposed state: `Data Engine's data_list` (or however you named it).
3. Inside the cell, just use Bubble's native dynamic expressions (e.g., Current cell's Product's price). No Regex needed!

✅ You also have access to these real-time calculations to build your dashboards:
📈 Data Engine's data_count (Items Count)
💰 Data Engine's calc_sum (Total Sum)
📊 Data Engine's calc_avg (Average Value)
⏱️ Data Engine's perf_time (Execution Time in ms) - Show off the speed to your users!

🔗 DEMO & SUPPORT:
Check our demo editor to see exactly how it's built:
https://bubble.io/page?id=dataengine-wusaver-demo&tab=Design&name=index

Need help or custom enterprise features? Reach out to [email protected]