Repotype

Linting for your entire repository. Not just code.

ESLint checks your code. Prettier formats it. Repotype checks your repository structure — folders, file naming, schemas, frontmatter, and documentation standards.

📖 Read the Documentation →

Install

npm install -g repotype
# or
npx repotype validate .

Quick Start

# Initialize config
repotype init .

# Validate
repotype validate .

# Auto-fix issues
repotype fix .

# Generate report
repotype report . --output report.md

What It Validates

• 📁 Folder structure — required directories, allowlists, path patterns
• 📋 File standards — naming conventions, companion files, JSON/YAML schemas
• 📝 Documentation — frontmatter schemas, required sections, template detection
• 🔒 Content policies — forbidden patterns, secret detection

Example Config

# repotype.yaml
version: "1"

defaults:
  unmatchedFiles: deny  # Strict mode

folders:
  - id: src-structure
    path: src
    requiredFolders: [components, hooks, utils]
    pathCase: kebab

files:
  - id: typescript
    glob: "src/**/*.ts"
    pathCase: kebab
    
  - id: docs
    glob: "docs/**/*.md"
    frontmatter:
      required: [title, description]

Documentation

Guide	Description
Getting Started	Installation and first steps
Configuration	Full config reference
Folder Rules	Control directory structure
File Rules	Validate files by pattern
CI Integration	GitHub Actions, GitLab CI
CLI Reference	All commands

CLI Commands

repotype init [target]           # Create repotype.yaml
repotype validate [target]       # Validate repository
repotype fix [target]            # Auto-fix violations
repotype report [target]         # Generate compliance report
repotype explain <file>          # Explain rules for a file
repotype status [target]         # Show operations status
repotype apply [target]          # Apply hooks/watcher config
repotype install-checks          # Install git hooks

CI Integration

# .github/workflows/repotype.yml
name: Repotype
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx repotype validate . --json

Share with Agents

Repotype is designed for human + agent teams. Add this to your agent instructions:

Use repotype validate . before committing. Run repotype fix . to auto-fix issues. Check repotype.yaml for repository standards.

License

MIT — Supernal Intelligence

---

Built to Help Fight Entropy with ♥ from Supernal Intelligence