stoplightio

stoplightio/spectral

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

3.2K stars 290 forks 3.2K watchers TypeScript Apache License 2.0
arazzo hacktoberfest json json-lint json-schema jsonpath linting oas oasv3 openapi openapi-specification openapi3 stoplight-oss stoplight-spectral swagger swagger-oss
View on GitHub Website
6 Open Issues Need Help Last updated: Aug 7, 2026

Open Issues Need Help

View All on GitHub
Publish arm64 Docker containers to https://hub.docker.com/r/stoplight/spectral about 3 hours ago
enhancement help wanted p/medium triaged
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss
Add logic/rule for identifying circular references 2 months ago
enhancement help wanted triaged cs/reported json-refs
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss
OAS - '$ref' properties on example values return invalid-ref errors. 3 months ago
t/bug help wanted triaged json-refs
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss
Lots of $ref to other files leads to random errors due to unprocessed $ref targets 3 months ago
enhancement help wanted triaged
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss
Add "Objects with properties must have type: object" rule to builtin spectral:oas ruleset 3 months ago
enhancement help wanted good first issue p/longterm triaged
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss
OAS 3.1 Security Schemes Relax "Scope" definition requirements - Updated Function/Rule ? 3 months ago
t/bug help wanted p/medium triaged
stoplightio/spectral
3.2K

A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI (v3.1, v3.0, and v2.0), Arazzo v1.0, as well as AsyncAPI v2.x.

TypeScript
#arazzo#hacktoberfest#json#json-lint#json-schema#jsonpath#linting#oas#oasv3#openapi#openapi-specification#openapi3#stoplight-oss#stoplight-spectral#swagger#swagger-oss