Erpnext Syntax Clientscripts

The erpnext-syntax-clientscripts skill enables AI agents to write and execute JavaScript code within the ERPNext application's client-side environment. It allows for dynamic manipulation of the user interface, data validation, and real-time calculations directly in browser-based forms without requiring server round-trips.

When to use it

• Implementing custom field validations that trigger immediately as a user types in a form.
• Creating dynamic UI updates, such as showing/hiding sections based on selected values.
• Performing client-side mathematical calculations or currency conversions before saving records.
• Automating repetitive data entry tasks within specific document types like Sales Orders or Purchase Receipts.

Key capabilities

• Executes JavaScript logic specifically scoped to the ERPNext frontend framework.
• Modifies DOM elements and form fields in real-time during user interaction.
• Integrates with existing ERPNext field definitions and document structures.
• Provides a lightweight alternative to server-side scripts for immediate UI feedback.

Example prompts

• "Write a client script for the 'Sales Order' doctype that automatically calculates the total line amount when the quantity or rate fields are changed."
• "Create a validation rule in a 'Purchase Receipt' form that prevents saving if the received quantity exceeds the ordered quantity by more than 5%."
• "Generate JavaScript code to toggle the visibility of an address field based on whether the customer's country is set to 'International'."

Tips & gotchas

Ensure your AI agent understands the specific data structure of ERPNext doctypes before generating scripts, as incorrect field references will cause runtime errors. Client-side scripts run in the browser context, so they cannot directly modify database records; use them only for UI logic and validation, relying on server scripts for actual data persistence.