README

Front-End Checklist

The essential checklist for modern web development, for humans and AI agents









---

Front-End Checklist is the open-source front-end quality system for humans and AI agents. It turns front-end best practices into a practical review workflow you can browse on the web, run through with MCP-compatible tools, or work through directly in this README.

---

 Introduction

- Website: frontendchecklist.io
- Rules: frontendchecklist.io/rules
- MCP server: mcp.frontendchecklist.io

Companion project: UX Patterns for Devs helps developers choose the right UI pattern before using Front-End Checklist to verify implementation quality.

 [!IMPORTANT]
 Use the website for browsing and filtering, the MCP server for agent workflows, and this README when you want the checklist in one place.

 What you get

- 386 English rules across 11 active categories
- 11 MCP tools exposed by the hosted server
- Rule pages with explanations, remediation guidance, and verification steps

 How to use this checklist

1. Start with the category navigator below and jump straight to the part of the checklist you need.
2. Work through the checkbox items that apply to your project, audit, or pull request.
3. Open the linked rule pages when you need the full guidance, examples, verification steps, and AI prompts.
4. Use frontendchecklist.io for interactive browsing, and mcp.frontendchecklist.io when you want agents to use the same rule corpus directly.

 Priority legend

- ![Critical][critical_img] means site-breaking, compliance-sensitive, or security-sensitive issues that should be fixed first.
- ![High][high_img] means issues with major impact on user experience, accessibility, performance, or discoverability.
- ![Medium][medium_img] means strong best practices that should be part of normal frontend quality review.
- ![Low][low_img] means useful improvements that are situational or lower urgency.

 Choose your workflow

 Browse online

- Explore all rules at frontendchecklist.io/rules
- Use curated checklists at frontendchecklist.io/checklists
- Open a category page for focused audits and implementation guidance

 Choose the right pattern first

Front-End Checklist helps you review implementation quality. If you are still deciding what interface to build, use UX Patterns for Devs to compare common UI patterns, understand tradeoffs, and find practical guidance for forms, navigation, data display, feedback states, authentication, and AI interfaces.

 Contribute to the checklist

- Install dependencies: pnpm install
- Run local development: pnpm dev
- Validate structure: pnpm validate:rule-structure
- Score the corpus: pnpm score:rules
- Regenerate derived artifacts: pnpm generate:skills and pnpm generate:readme

 Use with MCP

Connect an MCP-capable agent to Front-End Checklist for frontend code review, structured rule lookup, audits, and remediation workflows across React, Next.js, HTML, CSS, JavaScript, accessibility, performance, SEO, security, images, pri