astro-md-editor 0.0.3 → 0.0.5

package/.output/server/_ssr/index.mjs

@@ -440,7 +440,7 @@ function getResponse() {
   return event.res;
 }
 async function getStartManifest(matchedRoutes) {
-  const { tsrStartManifest } = await import("../_tanstack-start-manifest_v-CWdBk-ge.mjs");
+  const { tsrStartManifest } = await import("../_tanstack-start-manifest_v-Da8tuNDH.mjs");
   const startManifest = tsrStartManifest();
   const rootRoute = startManifest.routes[rootRouteId] = startManifest.routes[rootRouteId] || {};
   rootRoute.assets = rootRoute.assets || [];
@@ -596,31 +596,37 @@ function createMultiplexedStream(jsonStream, rawStreams) {
 }
 const manifest = { "e3ae5ae6db5120d43fecff71cd0258cb4a93807a1a382949ccd189596d190566": {
   functionName: "loadCollectionsData_createServerFn_handler",
-  importer: () => import("../__root-C4T8UKZy.mjs")
+  importer: () => import("../__root-CL_tq3ov.mjs")
 }, "b1ee42a5714ab9be8f37a4c5fca02ffd6269030b4d3ef663ff002865393e2386": {
   functionName: "saveSelectionToFile_createServerFn_handler",
-  importer: () => import("./index-wJDNoCM2.mjs")
+  importer: () => import("./index-BjQuGIib.mjs")
 }, "a215cd23c3ee5dbffd561330a77a2b6ed0e0b5b10aac60190e712ffa6067a121": {
   functionName: "deleteSelectionFromFile_createServerFn_handler",
-  importer: () => import("./index-wJDNoCM2.mjs")
+  importer: () => import("./index-BjQuGIib.mjs")
 }, "248b908cf72b9979ba134470388db1f63e57871f390fb58a8be8d0757531e84c": {
   functionName: "createSelectionFile_createServerFn_handler",
-  importer: () => import("./index-wJDNoCM2.mjs")
+  importer: () => import("./index-BjQuGIib.mjs")
 }, "28b009a83a8070215402885cb1254e3f7ab49160f54c955f55e15fd2119831e7": {
   functionName: "listImageAssets_createServerFn_handler",
-  importer: () => import("./ImageAssetBrowser-DWEdNK_g.mjs")
+  importer: () => import("./ImageAssetBrowser-DNDdTqtf.mjs")
 }, "1f487dcb5d0b909c2785163b904a0ee48e748b32783309e964b4502d83a2e7a7": {
   functionName: "getImageAssetPreview_createServerFn_handler",
-  importer: () => import("./ImageAssetBrowser-DWEdNK_g.mjs")
+  importer: () => import("./ImageAssetBrowser-DNDdTqtf.mjs")
 }, "dcd3839820feeaed3b1a4f86186dd05c2e7e26ffaacdeaba309f44d121c95ad1": {
   functionName: "listFileHistoryServerFn_createServerFn_handler",
-  importer: () => import("./file-history.api-BLrUovD8.mjs")
+  importer: () => import("./file-history.api-oydnxFVV.mjs")
 }, "02ba027930daf730cf535415a08fab7365d58edddcc678dbcb19c72f990c25b5": {
   functionName: "readFileRevisionServerFn_createServerFn_handler",
-  importer: () => import("./file-history.api-BLrUovD8.mjs")
+  importer: () => import("./file-history.api-oydnxFVV.mjs")
 }, "8346edc0b9da2addd68ca674ed9b2030f439d40deb713c45ef88393f5bdb91b9": {
   functionName: "getLocalImagePreviewServerFn_createServerFn_handler",
-  importer: () => import("./image-preview.api-bqd1erIP.mjs")
+  importer: () => import("./image-preview.api-pcN5PQhH.mjs")
+}, "3ba1a566c82090c8422dd6ca7258b2e1aed644206364441faf1bd80942f21745": {
+  functionName: "listIconifyCollectionsServerFn_createServerFn_handler",
+  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
+}, "c9dff6ed7373b505d6aeeb84c63f87a0d0c205051d9d817929a5b500e5e79e03": {
+  functionName: "listCollectionIconsServerFn_createServerFn_handler",
+  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
 } };
 async function getServerFnById(id) {
   const serverFnInfo = manifest[id];
@@ -1043,7 +1049,7 @@ let entriesPromise;
 let baseManifestPromise;
 let cachedFinalManifestPromise;
 async function loadEntries() {
-  const routerEntry = await import("./router-sxRLAh5a.mjs").then((n) => n.r);
+  const routerEntry = await import("./router-dPC3iVPs.mjs").then((n) => n.r);
   const startEntry = await import("./start-HYkvq4Ni.mjs");
   return { startEntry, routerEntry };
 }

package/.output/server/_ssr/{router-sxRLAh5a.mjs → router-dPC3iVPs.mjs}

@@ -47,7 +47,7 @@ const createSsrRpc = (functionId, importer) => {
     [TSS_SERVER_FUNCTION]: true
   });
 };
-const appCss = "/assets/styles-yeMm8TG7.css";
+const appCss = "/assets/styles-CezfLgHY.css";
 const CollectionsDataContext = reactExports.createContext(null);
 function CollectionsDataProvider({
   value,
@@ -144,7 +144,7 @@ function RootDocument({
     ] })
   ] });
 }
-const $$splitComponentImporter = () => import("./index-2cOxFkCu.mjs");
+const $$splitComponentImporter = () => import("./index-Bn1uKwTu.mjs");
 const Route = createFileRoute("/")({
   validateSearch: (search) => {
     const record = search;

package/.output/server/{_tanstack-start-manifest_v-CWdBk-ge.mjs → _tanstack-start-manifest_v-Da8tuNDH.mjs}

@@ -1,4 +1,4 @@
-const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "/Users/bimsina/Desktop/Development/Personal/astro-md-editor/src/routes/__root.tsx", "children": ["/"], "preloads": ["/assets/main-_miJG8oz.js"], "assets": [] }, "/": { "filePath": "/Users/bimsina/Desktop/Development/Personal/astro-md-editor/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-DVVq2QjK.js"] } }, "clientEntry": "/assets/main-_miJG8oz.js" });
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "/Users/bimsina/Desktop/Development/Personal/astro-md-editor/src/routes/__root.tsx", "children": ["/"], "preloads": ["/assets/main-DzXOjsqg.js"], "assets": [] }, "/": { "filePath": "/Users/bimsina/Desktop/Development/Personal/astro-md-editor/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-UQt6zCrS.js"] } }, "clientEntry": "/assets/main-DzXOjsqg.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -100,107 +100,107 @@ const assets = {
   "/favicon.ico": {
     "type": "image/vnd.microsoft.icon",
     "etag": '"f1e-ESBTjHetHyiokkO0tT/irBbMO8Y"',
-    "mtime": "2026-03-07T13:57:35.890Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 3870,
     "path": "../public/favicon.ico"
   },
+  "/manifest.json": {
+    "type": "application/json",
+    "etag": '"1f2-Oqn/x1R1hBTtEjA8nFhpBeFJJNg"',
+    "mtime": "2026-03-08T06:10:25.839Z",
+    "size": 498,
+    "path": "../public/manifest.json"
+  },
   "/logo192.png": {
     "type": "image/png",
     "etag": '"14e3-f08taHgqf6/O2oRVTsq5tImHdQA"',
-    "mtime": "2026-03-07T13:57:35.890Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 5347,
     "path": "../public/logo192.png"
   },
-  "/logo512.png": {
-    "type": "image/png",
-    "etag": '"25c0-RpFfnQJpTtSb/HqVNJR2hBA9w/4"',
-    "mtime": "2026-03-07T13:57:35.890Z",
-    "size": 9664,
-    "path": "../public/logo512.png"
-  },
   "/robots.txt": {
     "type": "text/plain; charset=utf-8",
     "etag": '"43-BEzmj4PuhUNHX+oW9uOnPSihxtU"',
-    "mtime": "2026-03-07T13:57:35.890Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 67,
     "path": "../public/robots.txt"
   },
-  "/manifest.json": {
-    "type": "application/json",
-    "etag": '"1f2-Oqn/x1R1hBTtEjA8nFhpBeFJJNg"',
-    "mtime": "2026-03-07T13:57:35.890Z",
-    "size": 498,
-    "path": "../public/manifest.json"
-  },
-  "/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2": {
-    "type": "font/woff2",
-    "etag": '"6568-cF1iUGbboMFZ8TfnP5HiMgl9II0"',
-    "mtime": "2026-03-07T13:57:35.439Z",
-    "size": 25960,
-    "path": "../public/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2"
-  },
   "/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2": {
     "type": "font/woff2",
     "etag": '"493c-n3Oy9D6jvzfMjpClqox+Zo7ERQQ"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 18748,
     "path": "../public/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2"
   },
   "/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2": {
     "type": "font/woff2",
     "etag": '"2be0-BP5iTzJeB8nLqYAgKpWNi5o1Zm8"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "mtime": "2026-03-08T06:10:25.332Z",
     "size": 11232,
     "path": "../public/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2"
   },
+  "/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2": {
+    "type": "font/woff2",
+    "etag": '"6568-cF1iUGbboMFZ8TfnP5HiMgl9II0"',
+    "mtime": "2026-03-08T06:10:25.332Z",
+    "size": 25960,
+    "path": "../public/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2"
+  },
+  "/logo512.png": {
+    "type": "image/png",
+    "etag": '"25c0-RpFfnQJpTtSb/HqVNJR2hBA9w/4"',
+    "mtime": "2026-03-08T06:10:25.839Z",
+    "size": 9664,
+    "path": "../public/logo512.png"
+  },
   "/assets/inter-greek-wght-normal-CkhJZR-_.woff2": {
     "type": "font/woff2",
     "etag": '"4a34-xor/hj4YNqI52zFecXnUbzQ4Xs4"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 18996,
     "path": "../public/assets/inter-greek-wght-normal-CkhJZR-_.woff2"
   },
-  "/assets/inter-latin-wght-normal-Dx4kXJAl.woff2": {
-    "type": "font/woff2",
-    "etag": '"bc80-8R1ym7Ck2DUNLqPQ/AYs9u8tUpg"',
-    "mtime": "2026-03-07T13:57:35.439Z",
-    "size": 48256,
-    "path": "../public/assets/inter-latin-wght-normal-Dx4kXJAl.woff2"
-  },
   "/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2": {
     "type": "font/woff2",
     "etag": '"14c4c-zz61D7IQFMB9QxHvTAOk/Vh4ibQ"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 85068,
     "path": "../public/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2"
   },
+  "/assets/inter-latin-wght-normal-Dx4kXJAl.woff2": {
+    "type": "font/woff2",
+    "etag": '"bc80-8R1ym7Ck2DUNLqPQ/AYs9u8tUpg"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 48256,
+    "path": "../public/assets/inter-latin-wght-normal-Dx4kXJAl.woff2"
+  },
   "/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2": {
     "type": "font/woff2",
     "etag": '"280c-nBythjoDQ0+5wVAendJ6wU7Xz2M"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 10252,
     "path": "../public/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2"
   },
-  "/assets/styles-yeMm8TG7.css": {
+  "/assets/styles-CezfLgHY.css": {
     "type": "text/css; charset=utf-8",
-    "etag": '"166a9-I6btGAgVFRFRXGymDNZj4iIz93M"',
-    "mtime": "2026-03-07T13:57:35.439Z",
-    "size": 91817,
-    "path": "../public/assets/styles-yeMm8TG7.css"
+    "etag": '"16c03-6spcY0zAbMWYIfx4MkgUIWefXb0"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 93187,
+    "path": "../public/assets/styles-CezfLgHY.css"
   },
-  "/assets/main-_miJG8oz.js": {
+  "/assets/main-DzXOjsqg.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"59339-CcbCeqp9UxyIUIPAD9lofPs515E"',
-    "mtime": "2026-03-07T13:57:35.439Z",
+    "etag": '"59339-tSYXNZ6CNL1Zt0KVnL8TeohfAog"',
+    "mtime": "2026-03-08T06:10:25.336Z",
     "size": 365369,
-    "path": "../public/assets/main-_miJG8oz.js"
+    "path": "../public/assets/main-DzXOjsqg.js"
   },
-  "/assets/index-DVVq2QjK.js": {
+  "/assets/index-UQt6zCrS.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"fa95d-3mgUdOunP1JUZweDUAkGUnl6d2w"',
-    "mtime": "2026-03-07T13:57:35.439Z",
-    "size": 1026397,
-    "path": "../public/assets/index-DVVq2QjK.js"
+    "etag": '"fd680-MTEy4A2zDMKeSP7AuzGHvXOYiSs"',
+    "mtime": "2026-03-08T06:10:25.337Z",
+    "size": 1037952,
+    "path": "../public/assets/index-UQt6zCrS.js"
   }
 };
 function readAsset(id) {

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bibek Timsina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,38 +2,38 @@
 
 [![npm version](https://img.shields.io/npm/v/astro-md-editor.svg)](https://www.npmjs.com/package/astro-md-editor)
 
-Editor UI for Astro content collections (`src/content`) with schema-aware frontmatter editing and markdown body editing.
+Schema-aware editor for Astro content collections. It lets you edit frontmatter and markdown/MDX together, validates on save, and can reuse values from file Git history.
 
-## Run
+Demo video: https://www.youtube.com/watch?v=-cI6ct8yLHM
 
-```bash
-npx astro-md-editor
-```
+https://github.com/user-attachments/assets/7f38b6a4-fe1a-4e30-80c8-19a58aa860f1
+
+## Quick start
 
 ```bash
-pnpm dlx astro-md-editor
+npx astro-md-editor
 # or
-pnpx astro-md-editor
+pnpm dlx astro-md-editor
 ```
 
-### Target project path
+By default, it targets the current directory.
 
-```bash
-# positional
-npx astro-md-editor /absolute/path/to/astro-project
+Target a specific Astro project:
 
-# flag
-npx astro-md-editor --path /absolute/path/to/astro-project
+```bash
+astro-md-editor /absolute/path/to/astro-project
+# or
+astro-md-editor --path /absolute/path/to/astro-project
 ```
 
-Path resolution order:
+Root resolution order:
 
-1. positional CLI arg (`astro-md-editor <astro-project-root>`)
-2. `--path=<astro-project-root>`
+1. positional argument (`astro-md-editor <astro-project-root>`)
+2. `--path`
 3. `APP_ROOT_PATH`
 4. current working directory
 
-### Port
+Port can be set with `PORT` or `NITRO_PORT`.
 
 ```bash
 PORT=1234 npx astro-md-editor
@@ -41,60 +41,37 @@ PORT=1234 npx astro-md-editor
 NITRO_PORT=1234 npx astro-md-editor
 ```
 
-The runtime reads `PORT`/`NITRO_PORT` for server port.
-
 ## Requirements
 
-- Astro project with collections in `src/content`.
-- Collection schemas available in `.astro/collections/*.schema.json`.
+- Astro project with collections under `src/content`
+- Generated collection schemas in `.astro/collections/*.schema.json`
 
-If schema files are missing, run:
+If schema files are missing, run in the target project:
 
 ```bash
 astro sync
 ```
 
-## Features
-
-- Reads `.astro/collections/*.schema.json`.
-- Scans `src/content/<collection>/**/*.{md,mdx,markdown}`.
-- Renders controls for schema fields (`string`, `number`, `boolean`, `enum`, `date`, arrays).
-- Edits frontmatter and markdown/MDX body in one flow.
-- Validates frontmatter with AJV before save.
-- Supports image field inference from `src/content.config.*` (`image()`, `z.array(image())`).
-- Supports image pickers for both `src` assets and `public` assets.
-- Includes a per-file Git History tab in the right sidebar (timeline-style commit list).
-- Shows commit message, author, and time; expands each item to inspect revision frontmatter.
-- Can apply a selected revision into the current draft with schema-safe frontmatter reapply (incompatible keys are skipped).
-- Applying history updates only the in-editor draft; normal Save flow still controls disk writes.
-
-## Local development
-
-```bash
-pnpm dev
-```
-
-`pnpm dev` uses `--path example-blog --port 3000`.
-
-Run dev against another project:
-
-```bash
-node scripts/dev.mjs /absolute/path/to/astro-project --port 3000
-```
-
-In dev mode, if schema files are missing, startup runs `astro sync` automatically for the selected project.
+## Highlights
 
-## Field overrides
+- Reads collection schemas and content files (`.md`, `.mdx`, `.markdown`)
+- Renders schema-aware controls (`string`, `number`, `boolean`, `enum`, `date`, arrays)
+- Validates frontmatter with AJV before saving
+- Infers image fields from `src/content.config.*` (`image()` / `z.array(image())`)
+- Supports image pickers for both `src` assets and `public` assets
+- Shows per-file Git history and applies selected revision values to the current draft safely
 
-Create `astro-md-editor.fields.json` at the Astro project root.
+## Field overrides (optional)
 
-Example:
+Create `astro-md-editor.fields.json` at the Astro project root to force specific UI controls.
 
 ```json
 {
   "blog": {
     "brandColor": { "type": "color" },
-    "coverAssetPath": { "type": "image", "mode": "public" }
+    "coverAssetPath": { "type": "image", "mode": "public" },
+    "menuIconFiltered": { "type": "icon", "icon_libraries": ["lucide", "mdi"] },
+    "menuIconAny": { "type": "icon" }
   },
   "snippet": {
     "galleryPaths": { "type": "image", "multiple": true, "mode": "public" }
@@ -102,23 +79,48 @@ Example:
 }
 ```
 
-Rules:
+Supported override types:
 
-- `type`: `image` or `color`
-- for `type: "image"`, optional `mode`: `asset` (default) or `public`
-- for `type: "image"`, optional `multiple: true` for array-style image input
-- shape: `{ [collectionName]: { [fieldName]: override } }`
+- `image` (`mode: "asset" | "public"`, optional `multiple: true`)
+- `color`
+- `icon` (optional `icon_libraries: string[]`)
 
-Precedence:
+Precedence: `astro-md-editor.fields.json` > inferred `image()` fields > schema defaults.
 
-1. `astro-md-editor.fields.json` overrides
-2. inferred `image()` / `array(image())` from content config
-3. schema-based fallback rendering
-
-Invalid or incompatible overrides are ignored with bootstrap warnings.
+Invalid or schema-incompatible overrides are ignored with startup warnings.
 
 ## Notes
 
-- `public` assets are saved as `/path/from/public`.
-- `src` assets are saved as relative paths from the content file (`./...` or `../...`).
-- Custom controls currently target top-level frontmatter fields.
+- Applying Git history updates the in-editor draft only; files are written only on normal Save
+- `public` assets are saved as `/path/from/public`
+- `src` assets are saved relative to the edited content file (`./...` or `../...`)
+- Icon values are saved as Iconify IDs (for example `lucide:messages-square`)
+- Custom controls currently target top-level frontmatter fields
+
+## Add a custom UI handler in code
+
+If you are extending the editor itself (not just using `astro-md-editor.fields.json`), add a new field kind in these places:
+
+1. `src/lib/schema-form.ts`
+   - Extend `FieldUiKind`, `FieldUiConfig`, and `ResolvedField`
+   - Update `resolveCustomFieldKind` to map your override kind to a resolved field
+
+2. `scripts/bootstrap-collections.mjs`
+   - Extend `fieldOverrideSchema` so config accepts your new `type`
+   - Update `getOverrideConfig` and `resolveSchemaCompatibilityKind`
+
+3. `src/components/editor/RightSidebar.tsx`
+   - Add your new field component
+   - Render it in the `resolvedFields.map(...)` switch (`field.kind === '<yourKind>'`)
+
+4. `src/lib/frontmatter-history-merge.ts`
+   - Update `isCompatibleValue` so Git-history apply validates your new kind correctly
+
+Quick checklist for a new kind (example: `slug`):
+
+- add `slug` to schema/field types
+- parse `type: "slug"` in bootstrap overrides
+- render `<SlugField />` in `RightSidebar`
+- add compatibility logic in history merge
+
+If any part is missing, the field falls back to default/unsupported handling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-md-editor",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
     ".output/",
     "index.mjs",
     "scripts/bootstrap-collections.mjs",
-    "README.md"
+    "README.md",
+    "LICENSE.md"
   ],
   "imports": {
     "#/*": "./src/*"

package/scripts/bootstrap-collections.mjs

@@ -36,6 +36,12 @@ const fieldOverrideSchema = z.discriminatedUnion('type', [
       type: z.literal('color'),
     })
     .strict(),
+  z
+    .object({
+      type: z.literal('icon'),
+      icon_libraries: z.array(z.string()).optional(),
+    })
+    .strict(),
 ]);
 
 function isRecord(value) {
@@ -673,7 +679,7 @@ async function runAstroSync(rootDir, env = process.env) {
   const astroCliPath = await resolveAstroCliPath(rootDir);
   if (!astroCliPath) {
     throw new Error(
-      `Collections are missing and Astro CLI was not found at ${resolve(
+      `Astro CLI was not found at ${resolve(
         rootDir,
         'node_modules/.bin/astro',
       )}. Install dependencies in ${rootDir} and try again.`,
@@ -968,9 +974,29 @@ function resolveSchemaCompatibilityKind(propertySchema, desiredKind) {
     return 'color';
   }
 
+  if (desiredKind === 'icon' && propertySchema.type === 'string') {
+    return 'icon';
+  }
+
   return undefined;
 }
 
+function normalizeIconLibraries(iconLibraries) {
+  if (!Array.isArray(iconLibraries)) {
+    return undefined;
+  }
+
+  const normalized = [
+    ...new Set(
+      iconLibraries
+        .map((value) => (typeof value === 'string' ? value.trim() : ''))
+        .filter((value) => value.length > 0)
+        .map((value) => value.toLowerCase()),
+    ),
+  ];
+  return normalized.length > 0 ? normalized : undefined;
+}
+
 function getOverrideConfig(override) {
   if (!override) {
     return undefined;
@@ -989,6 +1015,13 @@ function getOverrideConfig(override) {
     };
   }
 
+  if (override.type === 'icon') {
+    return {
+      kind: 'icon',
+      iconLibraries: normalizeIconLibraries(override.icon_libraries),
+    };
+  }
+
   return undefined;
 }
 
@@ -1002,7 +1035,13 @@ function resolveCollectionFieldUiKinds(params) {
 
   const resolvedKinds = {};
 
-  const applyKind = (fieldKey, nextKind, sourceLabel, mode = 'asset') => {
+  const applyKind = (
+    fieldKey,
+    nextKind,
+    sourceLabel,
+    mode = 'asset',
+    iconLibraries,
+  ) => {
     if (!nextKind) {
       return;
     }
@@ -1028,6 +1067,14 @@ function resolveCollectionFieldUiKinds(params) {
       return;
     }
 
+    if (compatibleKind === 'icon') {
+      resolvedKinds[fieldKey] = {
+        kind: 'icon',
+        iconLibraries,
+      };
+      return;
+    }
+
     resolvedKinds[fieldKey] = {
       kind: compatibleKind,
     };
@@ -1041,7 +1088,13 @@ function resolveCollectionFieldUiKinds(params) {
 
   for (const [fieldKey, override] of Object.entries(overrideEntries ?? {})) {
     const overrideConfig = getOverrideConfig(override);
-    applyKind(fieldKey, overrideConfig?.kind, 'custom', overrideConfig?.mode);
+    applyKind(
+      fieldKey,
+      overrideConfig?.kind,
+      'custom',
+      overrideConfig?.mode,
+      overrideConfig?.iconLibraries,
+    );
   }
 
   return Object.keys(resolvedKinds).length > 0 ? resolvedKinds : undefined;
@@ -1073,18 +1126,11 @@ export async function bootstrapCollections(argv = [], options = {}) {
     throw new Error(`Root path is not a directory: ${rootDir}`);
   }
 
-  let collectionsParsed = await buildCollectionsFromFilesystem(rootDir);
-  const hasAnySchema = collectionsParsed.collections.some(
-    (collection) => isRecord(collection) && collection.hasSchema === true,
-  );
-  if (!hasAnySchema && mode === 'development') {
-    const schemaDirPath = resolve(rootDir, COLLECTIONS_RELATIVE_PATH_PREFIX);
-    console.warn(
-      `[bootstrap] No schema files found in ${schemaDirPath}; running "astro sync" in ${rootDir}.`,
-    );
+  if (mode === 'development') {
+    console.warn(`[bootstrap] Running "astro sync" in ${rootDir}.`);
     await runAstroSync(rootDir, env);
-    collectionsParsed = await buildCollectionsFromFilesystem(rootDir);
   }
+  let collectionsParsed = await buildCollectionsFromFilesystem(rootDir);
 
   if (
     !isRecord(collectionsParsed) ||