Issue rules

Nordcraft's issue rules help you maintain high-quality standards in your projects by highlighting common problems.

Tip

To learn more about where issue rules are shown in the editor, check out the issues panel.

Tip

To see how issue rules are implemented, visit the Nordcraft GitHub repository.

Components

Rule	Severity	Auto fixes	Description
Components with no references	Warning	Delete the component	Components that are not referenced anywhere in your project are usually safe to remove unless they're used as exported web components.
Unknown component reference	Error	No	Finds references to components that do not exist. This helps you identify and correct broken references in your project.

Formulas

Rule	Severity	Auto fixes	Description
Project formulas with no references	Warning	Delete the formula	Project formulas that are not referenced anywhere in your project can lead to confusion and bloated projects. Nordcraft flags these unused formulas to help you keep your project clean and efficient.
Unknown project formula reference	Error	No	Finds references to project formulas that do not exist. This helps you identify and correct broken references in your project.
Legacy formula	Warning	Replace formula	Finds known legacy formulas that should no longer be used.
Component formulas with no reference	Warning	No	Finds component formulas that are not used by any other formulas in a component.
Unknown component formula input	Warning	No	Finds invalid component formula inputs.
Unknown project formula input	Warning	No	Finds invalid project formula inputs.
Unknown component formula reference	Warning	No	Finds references to unknown component formulas.
Unknown repeat index formula	Warning	No	Finds usage of repeat index formulas that are not within a valid repeat context.
Unknown repeat item formula	Warning	No	Finds usage of repeat item formulas that are not within a valid repeat context.

Actions

Rule	Severity	Auto fixes	Description
Project actions with no references	Warning	Delete the action	Project actions that are not referenced anywhere in your project can lead to confusion and bloated projects. This rule flags unused project actions to help keep your project clean and efficient.
Unknown project action references	Warning	No	Finds references to project actions that do not exist. This helps identify and correct broken references in projects.
Duplicate action argument name	Warning	No	Finds duplicate action arguments.
Unknown action event	Warning	Delete the event	Finds events in action references that are not declared in the referenced action.
Unknown action argument	Warning	Delete the argument	Finds arguments in action references that are not declared in the referenced action.
Legacy action	Warning	Replace the action	Finds known legacy actions that should no longer be used.
No console	Info	No	Detects usage of the Log to console action in workflows. While useful for debugging, leaving console logs in production code can lead to performance issues and cluttered output.

Variables

Rule	Severity	Auto fixes	Description
Variables with no references	Warning	Delete the variable	Variables that are not referenced anywhere in a component can be safely removed.
Unknown variable references	Error	No	Finds references to variables that do not exist. This helps identify and correct broken references in components.
Unknown variable setter	Warning	No	Trying to set a variable that doesn't exist will have no effect, but usually highlights an issue in the logic for a component.

Attributes

Rule	Severity	Auto fixes	Description
Attributes with no references	Warning	Delete the attribute	Attributes that are not referenced anywhere in a component are not needed and can be removed.
Unknown attribute reference	Error	No	Finds references to attributes that do not exist in a component. This helps you identify and correct broken references in your project.
Unknown component attribute	Error	Delete the component attribute	Identifies attributes on component nodes that don't exist on the target component. These invalid attributes can safely be removed.

Events

Rule	Severity	Auto fixes	Description
Duplicate event trigger	Warning	No	Flags duplicate event triggers on an element or component node. This usually happens in legacy projects.
Events with no references	Warning	Delete the event	Finds events in a component that are never triggered. These events can be removed to keep the component clean and efficient.
Unknown event	Error	No	Flags events declared on component nodes that don't exist in the target component.
Unknown event trigger	Error	No	Finds event triggers in components that don't match any of the declared events in the component.

APIs

Rule	Severity	Auto fixes	Description
APIs with no references	Warning	Delete the API	APIs that are never referenced in their component are usually not needed and can be removed.
Unknown API	Error	No	Finds references to unknown APIs.
Legacy API	Warning	No	Finds APIs that could be upgraded to the newer API v2 format. This conversion can be done from within the Nordcraft editor.
Invalid parser mode	Warning	No	Flags if an invalid parser mode is used in combination with SSR. The valid parser modes when fetching APIs during SSR are: `json`, `text`, and `auto`.
Invalid proxy body	Warning	No	Flags if an API is set to use templates (for cookie injection) in the body, but the API is not proxied.
Invalid proxy cookie	Warning	No	Flags APIs that are not proxied but are using a `Get Http-Only Cookie` formula. The template replacement will only work in the Nordcraft API proxy.
API inputs with no references	Warning	No	API inputs that are not used in the API (for headers, body etc.) are not needed.
Unknown API Input	Error	No	Finds references to unknown/invalid API inputs.
Unused API services	Warning	Delete the API service	API services that are not used by any API can safely be removed.
Unknown API service	Warning	No	Flags APIs that reference unknown API services. This means the API doesn't benefit from the schema provided by the API service and could indicate that a service was deleted by accident.

Context

Rule	Severity	Auto fixes	Description
No context consumption possible	Warning	No	Flags components that expose formulas or workflows in context, but don't have a slot element or a component as a child. This would mean that it was not possible for other components/elements to consume the context formulas/workflows.
Unknown context formula	Error	No	Finds references to unknown context formulas. This could happen if a context provider no longer had a formula by the name declared in the context consumer's reference.
Unknown context provider formula	Error	No	Finds references to un-exposed context formulas. This could happen if a context formula had previously been exposed in context, but is now no longer exposed.
Unknown context provider	Error	No	Finds references to context providers (components) that don't exist in the project.

Style

Rule	Severity	Auto fixes	Description
Invalid style syntax	Error	Delete the CSS property	Finds invalid CSS properties/syntax on elements and components.
Unknown classname	Error	No	Flags style variants that reference unknown classnames on an element.
CSS variables with no reference	Error	No	Finds all global CSS variables that are never referenced in a project.

Slots

Rule	Severity	Auto fixes	Description
Unknown component slot	Error	No	Flags slotted elements/components that reference an unknown slot in the host component.

DOM

Rule	Severity	Auto fixes	Description
Required direct child	Warning	No	Flags elements that have an invalid direct child element. For instance, a `<ul>` element can only have `li`, `script` or `template` elements as children.
Required direct parent	Warning	No	Flags elements that have an invalid direct parent element. For instance, a `<li>` element can only be a child of `ul` or `ol` elements.
Required element attribute	Warning	No	Flags elements that are missing required attributes. For instance, an `<img>` element must have a `src` attribute.
Required meta tag	Warning	No	Flags pages that have not declared a title or description meta tag.
Invalid interactive content	Warning	No	Flags elements that are not allowed to include interactive content elements, but include one or more as children.
Image without dimension	Warning	No	Flags `<img>` elements that do not have `width`, `height` or `aspect-ratio` attributes specified.
Non-empty void elements	Warning	No	Flags void elements that have children declared.

Logic

Rule	Severity	Auto fixes	Description
No static nodes	Warning	Delete condition \| Delete node	Flags elements that have a `Show` formula, but where the formula always evaluates to either `true` or `false`.
Unnecessary "And" formula	Warning	No	Finds `And` formulas where one of its conditions is always falsy. This means that the `And` formula is always falsy.
Unnecessary "Or" formula	Warning	No	Finds `Or` formulas where one of its conditions is always truthy. This means that the `Or` formula is always truthy.

Routing

Rule	Severity	Auto fixes	Description
Duplicate routes	Warning	No	Flags pages that have duplicate route declarations (where the path parameters match).
Duplicate URL parameter	Warning	No	Flags if a query parameter and a path parameter have the same name.
Unknown set URL parameter (legacy)	Warning	No	Finds actions that try to set a URL parameter (path or query) that does not exist.
Unknown set URL parameters	Warning	No	Finds actions that try to set one or multiple URL parameters (path or query) that do not exist.
Unknown URL parameter	Error	No	Finds references to URL parameters that do not exist.

Miscellaneous

Rule	Severity	Auto fixes	Description
Node with no references	Warning	Delete the orphan node	Finds nodes/elements that are not included by any other node/element. This can happen during copy/paste.
Require browser extension	Info	No	Highlights if the Nordcraft browser extension is not installed, but the project is setting/adding cookies in actions.
Unknown cookie	Info	No	Flags cookies referenced by the `Get Http-Only Cookie` formula that are not found by the Nordcraft browser extension.