Rules

Rules Reference

✅

Rules enabled when using the recommended configuration.

🔧

Rules that can be automatically fixed using the --fix option.

We currently support the following rules:

• construct-constructor-propertyEnforces that constructors of CDK Constructs have parameter names 'scope, id' or 'scope, id, props'.
  ✅
• no-construct-in-interfaceDisallows specifying CDK Construct types (e.g., Bucket) for interface properties.
  ✅
• no-construct-in-public-property-of-constructDisallows specifying Construct types (e.g., Bucket) for public properties of CDK Constructs.
  ✅
• no-construct-stack-suffixDisallows 'Construct' or 'Stack' strings in Construct and Stack IDs.
  ✅
• no-import-privateDisallows importing modules from private directories at different hierarchy levels.
• no-mutable-property-of-props-interfaceEnforces that properties of Props (interface) are specified with readonly.
  ✅🔧
• no-mutable-public-property-of-constructEnforces that public properties of Constructs are specified with readonly.
  ✅🔧
• no-parent-name-construct-id-matchDisallows specifying the parent class name in Construct IDs.
  ✅
• no-unused-propsEnforces that all properties defined in Construct Props (interface) are used within the constructor.
  ✅
• no-variable-construct-idDisallows using variables for Construct IDs.
  ✅
• pascal-case-construct-idEnforces PascalCase for Construct IDs.
  ✅🔧
• prefer-grants-propertyEnforces using the grants property instead of grant* methods.
  ✅
• prevent-construct-id-collisionTo prevent Construct ID collisions, disallows using literal strings for Construct IDs within loops.
• props-name-conventionEnforces that Props (interface) names follow the ${ConstructName}Props format.
• require-jsdocRequires JSDoc comments for properties of Props(interface) and public properties of Constructs.
• require-passing-thisEnforces passing 'this' to the constructor of Constructs.
  ✅🔧
• require-props-default-docRequires '@default' JSDoc for optional properties of Props (interface).

Recommended Rules

The recommended rules are suggested for maintaining correct code.
To use these rules, configure as follows:

Oxlint

// oxlint.config.ts
import { defineConfig } from "oxlint";
import cdkPlugin from "oxlint-plugin-awscdk";

export default defineConfig({
  // ✅ Add plugins
  extends: [cdkPlugin.configs.recommended],
  // ... some configs
});

ESLint

// eslint.config.mjs
import { defineConfig } from "eslint/config";
import cdkPlugin from "eslint-plugin-awscdk";

export default defineConfig({
  // ✅ Add plugins
  extends: [cdkPlugin.configs.recommended],
  // ... some configs
});

Strict Rules

The strict rules provide all available rules. To use these rules, configure as follows:

Oxlint

// oxlint.config.ts
import { defineConfig } from "oxlint";
import cdkPlugin from "oxlint-plugin-awscdk";

export default defineConfig({
  // ✅ Add plugins
  extends: [cdkPlugin.configs.strict],
  // ... some configs
});

ESLint

// eslint.config.mjs
import { defineConfig } from "eslint/config";
import cdkPlugin from "eslint-plugin-awscdk";

export default defineConfig({
  // ✅ Add plugins
  extends: [cdkPlugin.configs.strict],
  // ... some configs
});