Improve custom icon build script with TypeScript and error handling

[christian-byrne]

Summary

• Converts build/customIconCollection.js to TypeScript with proper type safety
• Adds comprehensive SVG validation and error handling
• Implements graceful failure handling - malformed icons don't break builds
• Removes verbose console logging, keeping only errors/warnings
• Updates documentation across README.md, CONTRIBUTING.md, and icons/README.md
• Adds missing @iconify/tailwind dependency

Improvements Made

1. TypeScript Migration

• Converted JavaScript build script to TypeScript
• Added proper interfaces for IconifyCollection and IconifyIcon
• Integrated with project's typecheck/lint/format pipeline

2. Enhanced Error Handling

• SVG content validation (checks for <svg> tags, balanced markup)
• Graceful handling of missing directories and malformed files
• Build continues even if individual icons fail to load
• Clear error messages for debugging

3. Reduced Noise

• Removed verbose per-icon logging that cluttered dev server output
• Kept only error/warning messages for actual issues
• Silent operation during successful builds

4. Documentation Updates

• Updated README.md to reflect custom icon support is now available
• Enhanced CONTRIBUTING.md with build script details
• Expanded icons/README.md with technical architecture details

Testing

• Icons display correctly in sidebar
• Build script handles malformed SVGs gracefully
• TypeScript compilation passes
• Linting and formatting pass
• Dev server runs cleanly without verbose logging

┆Issue is synchronized with this Notion page by Unito

[github-actions]

🎭 Playwright Test Results

✅ All tests passed across all browsers!

⏰ Completed at: 08/25/2025, 10:37:08 PM UTC

📊 Test Reports by Browser

• ✅ chromium-0.5x: View Report
• ✅ chromium-2x: View Report
• ✅ chromium: View Report
• ✅ mobile-chrome: View Report

---

🎉 Your tests are passing across all browsers!