` element with the brand name - Preferred viewBox: `0 0 24 24` (match library convention) - File size must be under 50KB - No `<script>` tags, event handlers, or `javascript:` URIs - No embedded raster images (`<image>` with base64 data) - No `<?xml>` declarations or `<!DOCTYPE>` preambles ### Fill and Color Rules - `default.svg`: Must use the brand hex color as `fill` on `<svg>` root (not `currentColor`) - `mono.svg`: Must use `fill="currentColor"` on `<svg>` root - `light.svg`: Must use `fill="#ffffff"` or similar light color - `dark.svg`: Must use `fill="#1a1a2e"` or similar dark color - Detail elements (eyes, pupils, accents) that contrast with the body must have explicit `fill` overrides - they must not inherit the root fill if that makes them invisible - Stroke colors on antennae, lines, or accents must contrast with adjacent filled shapes - same-color strokes over same-color fills are invisible - Never include a viewport-covering rectangle like `<path d="M0 0h24v24H0z"/>` without `fill="none"` - this covers the entire icon ### icons.json Registry - Located at `src/data/icons.json` - Entries must be alphabetically sorted by `slug` - Required fields: `slug`, `title`, `aliases`, `hex`, `categories`, `variants`, `license`, `url` - `hex` must not include `#` prefix (e.g. `"f43f5e"` not `"#f43f5e"`) - `variants` object keys must match filenames in `public/icons/{slug}/` - `categories` must use existing category names (check existing entries) ### Variant File Naming ``` public/icons/{slug}/ default.svg # Required - brand color mono.svg # Recommended - inherits text color light.svg # Optional - for dark backgrounds dark.svg # Optional - for light backgrounds color.svg # Optional - multi-color/gradient version wordmark.svg # Optional - text logo wordmarkLight.svg # Optional - light text logo wordmarkDark.svg # Optional - dark text logo ``` ### Slug Naming Convention - Lowercase, hyphen-separated - No uppercase, no spaces, no underscores - Must match the directory name under `public/icons/` ## Code Quality Rules ### TypeScript - No `any` types - Strict mode enabled - Server Components by default, `"use client"` only when needed ### Styling - Tailwind CSS only, no inline styles or CSS modules, except a narrow exception for CSS custom properties carrying a genuinely per-instance runtime value (e.g. a color derived from an icon's own hex) that cannot be expressed as a static utility class - shadcn/ui components, extend don't reinvent - Phosphor icons (`@phosphor-icons/react/dist/ssr`) for new or touched UI chrome; existing untouched Lucide usage can stay during the gradual migration, but do not add new Lucide icons ### Git - Never commit directly to `main` - Conventional commit messages: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `perf:` - No AI tool mentions in commit messages ## Common Review Pitfalls 1. **Invisible elements**: Fill color matches background or parent fill - always verify contrast 2. **Bounding box paths**: `M0 0hWvH` rectangles that cover the entire icon 3. **Wrong alphabetical position**: icons.json must stay sorted by slug 4. **Missing fill overrides**: Child elements inheriting root fill when they need a different color 5. **Inconsistent viewBox**: All icons in a PR should use the same coordinate space as the library standard 6. **Google Fonts in SVG**: External `@import url()` for fonts will not render in most contexts  # This is NOT the Next.js you know This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices. This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.

# thesvg - AI Review Guidelines ## SVG Icon Submission Rules ### Required - Every icon directory must have `default.svg` - Every SVG must have a valid `viewBox` attribute - Every SVG must contain a `` element with the brand name - Preferred viewBox: `0 0 24 24` (match library convention) - File size must be under 50KB - No `<script>` tags, event handlers, or `javascript:` URIs - No embedded raster images (`<image>` with base64 data) - No `<?xml>` declarations or `<!DOCTYPE>` preambles ### Fill and Color Rules - `default.svg`: Must use the brand hex color as `fill` on `<svg>` root (not `currentColor`) - `mono.svg`: Must use `fill="currentColor"` on `<svg>` root - `light.svg`: Must use `fill="#ffffff"` or similar light color - `dark.svg`: Must use `fill="#1a1a2e"` or similar dark color - Detail elements (eyes, pupils, accents) that contrast with the body must have explicit `fill` overrides - they must not inherit the root fill if that makes them invisible - Stroke colors on antennae, lines, or accents must contrast with adjacent filled shapes - same-color strokes over same-color fills are invisible - Never include a viewport-covering rectangle like `<path d="M0 0h24v24H0z"/>` without `fill="none"` - this covers the entire icon ### icons.json Registry - Located at `src/data/icons.json` - Entries must be alphabetically sorted by `slug` - Required fields: `slug`, `title`, `aliases`, `hex`, `categories`, `variants`, `license`, `url` - `hex` must not include `#` prefix (e.g. `"f43f5e"` not `"#f43f5e"`) - `variants` object keys must match filenames in `public/icons/{slug}/` - `categories` must use existing category names (check existing entries) ### Variant File Naming ``` public/icons/{slug}/ default.svg # Required - brand color mono.svg # Recommended - inherits text color light.svg # Optional - for dark backgrounds dark.svg # Optional - for light backgrounds color.svg # Optional - multi-color/gradient version wordmark.svg # Optional - text logo wordmarkLight.svg # Optional - light text logo wordmarkDark.svg # Optional - dark text logo ``` ### Slug Naming Convention - Lowercase, hyphen-separated - No uppercase, no spaces, no underscores - Must match the directory name under `public/icons/` ## Code Quality Rules ### TypeScript - No `any` types - Strict mode enabled - Server Components by default, `"use client"` only when needed ### Styling - Tailwind CSS only, no inline styles or CSS modules, except a narrow exception for CSS custom properties carrying a genuinely per-instance runtime value (e.g. a color derived from an icon's own hex) that cannot be expressed as a static utility class - shadcn/ui components, extend don't reinvent - Phosphor icons (`@phosphor-icons/react/dist/ssr`) for new or touched UI chrome; existing untouched Lucide usage can stay during the gradual migration, but do not add new Lucide icons ### Git - Never commit directly to `main` - Conventional commit messages: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `perf:` - No AI tool mentions in commit messages ## Common Review Pitfalls 1. **Invisible elements**: Fill color matches background or parent fill - always verify contrast 2. **Bounding box paths**: `M0 0hWvH` rectangles that cover the entire icon 3. **Wrong alphabetical position**: icons.json must stay sorted by slug 4. **Missing fill overrides**: Child elements inheriting root fill when they need a different color 5. **Inconsistent viewBox**: All icons in a PR should use the same coordinate space as the library standard 6. **Google Fonts in SVG**: External `@import url()` for fonts will not render in most contexts  # This is NOT the Next.js you know This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices. This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.