feat(core): enhance icon configuration and caching system; add new CLI commands for cache management and update Figma integration

Author: MRBadri

apps/docs/.iconsync/cache/index.json

@@ -0,0 +1,34 @@
+{
+  "30788:66895-B6R9BOyrbu0h3dVMhh1kkT": {
+    "nodeHash": "f554d37c20885422",
+    "filePath": "icons/element-category-heading.svg",
+    "downloadedAt": "2025-09-09T21:56:34.096Z",
+    "nodeId": "30788:66895",
+    "nodeName": "Element / Category Heading",
+    "fileId": "B6R9BOyrbu0h3dVMhh1kkT"
+  },
+  "30789:32174-B6R9BOyrbu0h3dVMhh1kkT": {
+    "nodeHash": "59629728c0e48240",
+    "filePath": "icons/arrow-chevron_right_duo.svg",
+    "downloadedAt": "2025-09-09T21:56:34.622Z",
+    "nodeId": "30789:32174",
+    "nodeName": "Arrow / Chevron_Right_Duo",
+    "fileId": "B6R9BOyrbu0h3dVMhh1kkT"
+  },
+  "30789:32168-B6R9BOyrbu0h3dVMhh1kkT": {
+    "nodeHash": "b63f5e2bb9d436ba",
+    "filePath": "icons/arrow-unfold_more.svg",
+    "downloadedAt": "2025-09-09T21:56:34.635Z",
+    "nodeId": "30789:32168",
+    "nodeName": "Arrow / Unfold_More",
+    "fileId": "B6R9BOyrbu0h3dVMhh1kkT"
+  },
+  "30789:32124-B6R9BOyrbu0h3dVMhh1kkT": {
+    "nodeHash": "77ba224d5f1cea3d",
+    "filePath": "icons/arrow-arrow_down_up.svg",
+    "downloadedAt": "2025-09-09T21:56:34.783Z",
+    "nodeId": "30789:32124",
+    "nodeName": "Arrow / Arrow_Down_Up",
+    "fileId": "B6R9BOyrbu0h3dVMhh1kkT"
+  }
+}

apps/docs/icon.config.ts

@@ -1,24 +1,27 @@
-import { defineConfig, parseFigmaUrl } from "@figmicon/core";
+/// <reference types="node" />
+import { iconConfig } from "@figmicon/core";
 
 // https://www.figma.com/design/iH0P8rAVJjqln9jiuNqY7R/VergeCloud?node-id=10806-24901&m=dev
 
 // TODO: check this URL
 // https://www.figma.com/design/B6R9BOyrbu0h3dVMhh1kkT/coolicons-%7C-Free-Iconset--Community-?node-id=30789-32015&m=dev
+// https://www.figma.com/design/B6R9BOyrbu0h3dVMhh1kkT/coolicons-%7C-Free-Iconset--Community-?node-id=30788-66894&t=AXIVkr6jFRczopB2-4
 
-export default defineConfig({
+export default iconConfig({
   figma: {
     token: process.env.FIGMA_TOKEN!,
+    url: "https://www.figma.com/design/B6R9BOyrbu0h3dVMhh1kkT/coolicons-%7C-Free-Iconset--Community-?node-id=30788-66894&t=AXIVkr6jFRczopB2-4",
     // fileId: "iH0P8rAVJjqln9jiuNqY7R",
     // nodeId: "10806-24901",
     // INFO: you can use parseFigmaUrl to parse the url alternative to fileId and nodeId
-    ...parseFigmaUrl(
-      "https://www.figma.com/design/B6R9BOyrbu0h3dVMhh1kkT/coolicons-%7C-Free-Iconset--Community-?node-id=30789-32168&m=dev"
-    ),
-  },
-  fetch: {
-    // nodeTypes: ["COMPONENT", "COMPONENT_SET"],
-    generateFileName: (node, parentNode) => node.name + "--" + parentNode.name,
-    outDir: "icons/badri",
-    sanitizeName: true,
+    // ...parseFigmaUrl(
+    //   "https://www.figma.com/design/B6R9BOyrbu0h3dVMhh1kkT/coolicons-%7C-Free-Iconset--Community-?node-id=30788-66894&t=AXIVkr6jFRczopB2-4"
+    // ),
   },
+  // fetch: {
+  //   // nodeTypes: ["COMPONENT", "COMPONENT_SET"],
+  //   generateFileName: (node, parentNode) => node.name + "--" + parentNode.name,
+  //   // outDir: "icons/badri",
+  //   sanitizeName: true,
+  // },
 });

apps/docs/icons/arrow-arrow_down_up.svg

@@ -8,7 +8,9 @@
     "dev": "next dev -p 3002",
     "lint": "next lint",
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf .next",
-    "icon": "figmicon fetch --out tmp/icons"
+    "icon:fetch": "figmicon fetch --out tmp/icons",
+    "icon:cache:stats": "figmicon cache:stats",
+    "icon:cache:clear": "figmicon cache:clear"
   },
   "dependencies": {
     "@acme/utils": "workspace:*",

apps/docs/icons/arrow-chevron_right_duo.svg

@@ -0,0 +1,36 @@
+```
+packages/core/
+├── src/
+│ ├── features/ # 🎯 Feature-based organization
+│ │ ├── config/ # Configuration management
+│ │ │ ├── index.ts # Main exports
+│ │ │ ├── loader.ts # Config loading logic
+│ │ │ ├── schema.ts # Zod schemas & validation
+│ │ │ └── types.ts # Config-specific types
+│ │ ├── figma/ # Figma API integration
+│ │ │ ├── index.ts # Main exports
+│ │ │ ├── client.ts # Figma API client
+│ │ │ ├── parser.ts # URL parsing & utilities
+│ │ │ └── types.ts # Figma-specific types
+│ │ ├── cache/ # Caching system
+│ │ │ ├── index.ts # Main exports
+│ │ │ ├── node-cache.ts # Node.js cache implementation
+│ │ │ └── types.ts # Cache-specific types
+│ │ ├── fetch/ # Icon fetching
+│ │ │ ├── index.ts # Main exports
+│ │ │ ├── download.ts # Download logic
+│ │ │ ├── document.ts # Document fetching
+│ │ │ └── types.ts # Fetch-specific types
+│ │ └── generate/ # Code generation
+│ │ ├── index.ts # Main exports
+│ │ ├── react.ts # React component generation
+│ │ ├── sprite.ts # SVG sprite generation
+│ │ └── types.ts # Generation types
+│ ├── cli/ # 🖥️ CLI commands
+│ │ ├── index.ts # CLI setup & routing
+│ │ ├── fetch.ts # Fetch command
+│ │ ├── cache.ts # Cache management commands
+│ │ └── utils.ts # CLI utilities
+│ └──
+└──
+```

apps/docs/icons/arrow-unfold_more.svg

@@ -0,0 +1,11 @@
+# TODO
+
+- [ ] Handle caching
+- [ ] Handle rate limiting
+- [ ] Generate icons with SVGR
+- [ ] Generate sprite sheets
+- [ ] Generate React components
+- [ ] Add example apps
+- [ ] Create documentation app
+- [ ] Rename packages
+- [ ] Handle init command for initial config

apps/docs/icons/element-category-heading.svg

@@ -0,0 +1,49 @@
+import { loadConfig } from "../features/config";
+import { NodeCache } from "@/features/cache";
+import { green, cyan, yellow } from "kolorist";
+import { cacheLogger } from "@/features/cache";
+
+export const cacheStatsCommand = async () => {
+  const { source } = await loadConfig();
+
+  if (!source) {
+    console.error(cacheLogger(), "❌", "Could not find config file path");
+    return;
+  }
+
+  const nodeCache = new NodeCache(source);
+  const stats = await nodeCache.getCacheStats();
+
+  console.log(cacheLogger(), "📊", "Cache Statistics:");
+  console.log(`  Total entries: ${cyan(stats.totalEntries.toString())}`);
+  console.log(`  Cache size: ${cyan(stats.cacheSize)}`);
+
+  if (stats.oldestEntry) {
+    console.log(
+      `  Oldest entry: ${yellow(new Date(stats.oldestEntry).toLocaleString())}`
+    );
+  }
+
+  if (stats.newestEntry) {
+    console.log(
+      `  Newest entry: ${yellow(new Date(stats.newestEntry).toLocaleString())}`
+    );
+  }
+
+  if (stats.totalEntries === 0) {
+    console.log(yellow("  No cache entries found"));
+  }
+};
+
+export const cacheClearCommand = async () => {
+  const { source } = await loadConfig();
+
+  if (!source) {
+    console.error(cacheLogger(), "❌", "Could not find config file path");
+    return;
+  }
+
+  const nodeCache = new NodeCache(source);
+  await nodeCache.clearCache();
+  console.log(cacheLogger(), green("✔"), "Cache cleared successfully");
+};