Spectral Linter for VS Code

The Spectral VS Code Extension brings the power of Spectral to your favorite editor.

Spectral is a flexible object linter with out of the box support for OpenAPI v2 and v3, Arazzo, JSON Schema, and AsyncAPI v2 and v3.

Features

Lint-on-save
Lint-on-type
Custom ruleset support (.spectral.json, .spectral.yaml, .spectral.yml or .spectral.js)
Intellisense for custom ruleset editing
Support for JSON and YAML input

Requirements

Node.js >= 20
Visual Studio Code version 1.95 or higher.

Installation

Install from the Visual Studio Code Marketplace
Install via the CLI: code --install-extension stoplight.spectral

Extension Settings

This extension contributes the following settings:

spectral.enable: Controls whether or not Spectral is enabled.
spectral.rulesetFile: Location of the ruleset file to use when validating. If omitted, the default is a .spectral.(json|yaml|yml) in the same folder as the document being validated. Paths are relative to the workspace. This can also be a remote HTTP url.
spectral.run: Run the linter on save (onSave) or as you type (onType).
spectral.validateFiles: An array of file globs (e.g., **/*.yaml) which should be validated by Spectral. If language identifiers are also specified, the file must match both in order to be validated. You can also use negative file globs (e.g., !**/package.json) here to exclude files.
spectral.validateLanguages: An array of language IDs (e.g., yaml, json) which should be validated by Spectral. If file globs are also specified, the file must match both in order to be validated.

Thanks

License