🍚 깃밥 PRO가 열렸어요 — 월 3,900원 · 알아보기 →
shadcn-ui/lint

AI 에이전트가 Tailwind 디자인 시스템 규칙을 검증할 수 있는 ESLint/Oxlint 플러그인

설치형 도구맘대로 써도 됨 · MIT디자인·UI 컴포넌트TypeScript난이도
3,109👀 530 찜
62포크24이슈
36초로 맛보기한국어

자막 포함 · 2026-09-25 제작

중간맛 분석

ESLint 9.30+ 또는 Oxlint 1.80+를 지원하는 TypeScript 기반 린터 플러그인입니다. no-restyle, no-raw-colors, no-arbitrary-values 등 6가지 핵심 규칙을 제공하며, 컴포넌트별 contracts 설정으로 세밀한 클래스 허용/차단이 가능합니다. 150회 이상의 에이전트 테스트에서 거의 모든 태스크가 1회 피드백 만에 위반 0건을 달성했고, Claude 모델 기준 비용이 10~48% 절감되었다는 실측 데이터가 있습니다. install 후 설정 파일 하나만 추가하면 기존 프로젝트에 즉시 적용 가능합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • AI 코딩 에이전트가 디자인 시스템 규칙을 자동으로 학습하고 준수해야 할 때
  • 팀 전체가 동일한 컴포넌트 사용 규칙을 강제하고 싶을 때
  • 임의 색상값이나 비표준 Tailwind 클래스 사용을 프로젝트 전반에서 금지하고 싶을 때

핵심 기능

컴포넌트별 Tailwind 클래스 허용/차단 규칙 정의 (contracts)에러 메시지에 실제 컴포넌트 variants와 테마 경로를 포함한 맥락 있는 수정 안내ESLint와 Oxlint 모두 지원, shadcn/ui 없이도 모든 Tailwind v4 프로젝트에 적용 가능

대안 대비 차별점

TypeScript 타입 오류와 달리 '무엇이 잘못됐는지'뿐만 아니라 '디자인 시스템에서 어떻게 고쳐야 하는지'까지 에러 메시지에 포함해 AI 에이전트의 자가 수정을 가능하게 합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Node.js 20.19 이상
  • ESLint 9.30 이상 또는 Oxlint 1.80 이상
  • Tailwind CSS v4 프로젝트

바로 차려먹기Node.js (pnpm)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/shadcn-ui/lint.git &&
cd lint &&
pnpm install

실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. 패키지 설치 (Oxlint 사용 시)
npm install -D @shadcn/lint oxlint
  1. .oxlintrc.json 설정 파일 생성
cat > .oxlintrc.json << 'EOF'
{
  "jsPlugins": ["@shadcn/lint"],
  "rules": {
    "shadcn/no-restyle": [
      "error",
      {
        "allow": ["layout"]
      }
    ]
  }
}
EOF
  1. 린터 실행
npx oxlint
  1. (선택) ESLint를 선호하는 경우 패키지 설치
npm install -D @shadcn/lint eslint @typescript-eslint/parser
  1. (선택) eslint.config.mjs 생성 후 ESLint 실행
npx eslint .
  1. package.json의 lint 스크립트 등록 및 AGENTS.md에 lint 실행 지시 추가
npm pkg set scripts.lint="oxlint"

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try shadcn-ui/lint

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

3,1097일 증가분은 비교 데이터가 부족해요

확인 시각

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

「디자인·UI 컴포넌트」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/shadcn-ui/lint.svg)](https://www.gitbap.com/r/shadcn-ui/lint)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기