{"id":29874961,"url":"https://github.com/hugorcd/nuxt-ui-rules","last_synced_at":"2025-10-08T14:53:18.399Z","repository":{"id":304159719,"uuid":"1015021109","full_name":"HugoRCD/nuxt-ui-rules","owner":"HugoRCD","description":"Comprehensive guidelines for AI assistants working with Nuxt UI v3. Prevents common v2→v3 migration errors and provides best practices for modern Nuxt UI development.","archived":false,"fork":false,"pushed_at":"2025-07-07T19:31:16.000Z","size":25,"stargazers_count":59,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-04T05:51:27.718Z","etag":null,"topics":["best-practices","claude","cursor","cursor-rules","guidelines","nuxt-ui","rules"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HugoRCD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/funding.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["HugoRCD"]}},"created_at":"2025-07-06T21:28:20.000Z","updated_at":"2025-09-23T20:05:05.000Z","dependencies_parsed_at":"2025-07-13T01:15:25.911Z","dependency_job_id":null,"html_url":"https://github.com/HugoRCD/nuxt-ui-rules","commit_stats":null,"previous_names":["hugorcd/nuxt-ui-rules"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HugoRCD/nuxt-ui-rules","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HugoRCD%2Fnuxt-ui-rules","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HugoRCD%2Fnuxt-ui-rules/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HugoRCD%2Fnuxt-ui-rules/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HugoRCD%2Fnuxt-ui-rules/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HugoRCD","download_url":"https://codeload.github.com/HugoRCD/nuxt-ui-rules/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HugoRCD%2Fnuxt-ui-rules/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278963830,"owners_count":26076542,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["best-practices","claude","cursor","cursor-rules","guidelines","nuxt-ui","rules"],"created_at":"2025-07-31T01:45:42.449Z","updated_at":"2025-10-08T14:53:18.368Z","avatar_url":"https://github.com/HugoRCD.png","language":null,"readme":"# Guidelines for AI Assistants\n\nLeverage the full power of Nuxt UI in your AI-powered workflow. These guidelines are designed to help AI coding assistants like Cursor, Windsurf, Claude Code, and others understand the best practices for working with the Nuxt UI component library.\n\n## Available Rule Sets\n\nWe provide two versions of Nuxt UI rules to fit different needs:\n\n### 📚 Complete Rules (`nuxt-ui.md`) - **Recommended**\n- **~600 lines** - Comprehensive documentation and examples\n- **Detailed breaking changes** - Full v2 → v3 migration guide\n- **Advanced patterns** - Theming, performance, accessibility, TypeScript\n- **Best for most projects and learning**\n\n### 📋 Minimal Rules (`nuxt-ui-minimal.md`) \n- **~140 lines** - Optimized for AI assistants with token limits\n- **Essential changes only** - Core breaking changes and patterns\n- **Quick reference** - Most common pitfalls to avoid\n- **For AI assistants with limited context**\n\n## Getting Started\n\n**Recommended** → Use the [complete rules](https://github.com/hugorcd/nuxt-ui-rules/blob/main/rules/nuxt-ui.md?plain=1)\n\n**For AI assistants with limited context** → Use the [minimal rules](https://github.com/hugorcd/nuxt-ui-rules/blob/main/rules/nuxt-ui-minimal.md?plain=1)\n\n## Using with Cursor\n\n**Option 1 - Via Settings Interface (Recommended)** 🎯\n1. Open Cursor Settings (`Cmd/Ctrl + ,`)\n2. Navigate to **\"Rules for AI\"** tab\n3. Copy and paste your chosen rule content:\n   - **Complete**: Copy from [nuxt-ui.md](https://github.com/hugorcd/nuxt-ui-rules/blob/main/rules/nuxt-ui.md?plain=1)\n   - **Minimal**: Copy from [nuxt-ui-minimal.md](https://github.com/hugorcd/nuxt-ui-rules/blob/main/rules/nuxt-ui-minimal.md?plain=1)\n\n**Option 2 - Via File Configuration**\n1. Create `.cursor/rules/nuxt-ui.mdc` in your project root\n2. Copy your chosen rule content into this file\n\n## Using with Claude Code\n\n### On-Demand Context\n\nPlace your chosen rule file in your project directory, for instance, `rules/nuxt-ui.md`. Then, anytime you need Claude to understand Nuxt UI best practices, simply `@`-mention the file path in your prompt to load it into the current session's context.\n","funding_links":["https://github.com/sponsors/HugoRCD"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugorcd%2Fnuxt-ui-rules","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhugorcd%2Fnuxt-ui-rules","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugorcd%2Fnuxt-ui-rules/lists"}