eslint-plugin-repo

eslint-plugin-repo is a repository policy lint layer for files that teams usually forget until CI fails: repository governance docs, templates, and provider CI/CD configuration.

If you only read one page after this, use Getting Started.

What this plugin is for

Use this plugin when you want policy checks such as:

• baseline repository requirements (recommended preset)
• provider-specific CI/CD and hosting policies (GitHub, GitLab, Bitbucket, Codeberg / Forgejo, AWS, Azure, Google Cloud, Docker, Vercel, Netlify, DigitalOcean)
• AI workflow guidance files (AI preset)

Flat Config shape

Start with the baseline and layer only what matches your repository:

import repoPlugin from "eslint-plugin-repo";

export default [repoPlugin.configs.recommended];

Then add provider presets from Presets as needed.

How to navigate this docs section

• Adoption path: Getting Started
• Preset comparison: Presets overview
• Strict profile: Strict preset
• Complete catalog: All preset
• Rule examples: require-readme-file, require-license-file, require-security-policy-file, require-github-actions-workflow-file, require-gitlab-ci-config-file

Recommended rollout sequence

1. Enable repoPlugin.configs.recommended.
2. Add the provider preset(s) your repo actually uses.
3. Resolve findings and tune workflow expectations.
4. Add repoPlugin.configs.strict only after baseline adoption is stable.

Next: Go to Getting Started.