@grove-dev/astro 0.2.13 → 0.2.16

package/templates/default/package.json

@@ -25,9 +25,9 @@
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",
-    "@grove-dev/astro": "0.2.13",
-    "@grove-dev/cli": "0.2.13",
-    "@grove-dev/core": "0.2.13",
+    "@grove-dev/astro": "0.2.16",
+    "@grove-dev/cli": "0.2.16",
+    "@grove-dev/core": "0.2.16",
     "@tailwindcss/vite": "^4.3.0",
     "astro": "^6.4.4",
     "marked": "^18.0.0",

package/templates/default/public/llms-full.txt

@@ -1,6 +1,6 @@
 # example.com — full directory
 
-Generated: 2026-06-13T10:16:37.910Z
+Generated: 2026-06-15T13:49:39.319Z
 Records: 8
 
 ---

package/templates/default/public/sitemap.xml

@@ -2,61 +2,61 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://example.com/</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://example.com/projects</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
     <loc>https://example.com/projects/coolify</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/gitea</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/hoppscotch</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/inventree</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/label-studio</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/logseq</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/private-gpt</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/wakapi</loc>
-    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>

package/templates/default/src/data/records.ts

@@ -67,6 +67,9 @@ interface SiteConfigPayload {
     kind?: "project" | "resource" | "entity";
     routeSlug?: string;
     itemSlug?: string;
+    /** V1 canonical field name for the record detail slug
+     * (replaces the V0 `itemSlug` field). */
+    recordSlug?: string;
     labelSingular?: string;
     labelPlural?: string;
   };
@@ -226,10 +229,11 @@ export function indexSlug(): string {
   return blueprintConfig.routeSlug ?? "projects";
 }
 
-/** URL slug for a single item detail page (the dynamic
- * `[itemSlug]` segment). */
-export function itemSlug(): string {
-  return blueprintConfig.itemSlug ?? "project";
+/** URL slug for a single record detail page (the dynamic
+ * `[recordSlug]` segment). Default "project" for backwards-compat
+ * with V0-published configs that exposed the field as `itemSlug`. */
+export function recordSlugConfig(): string {
+  return blueprintConfig.recordSlug ?? blueprintConfig.itemSlug ?? "project";
 }
 
 /** Singular human label, e.g. "project", "resource", "entity". */

package/templates/default/src/pages/[slug]/{[itemSlug].astro → [recordSlug].astro}

@@ -17,7 +17,7 @@
  *  Generic across the 3 record kinds (project / resource / entity) —
  *  non-project fields simply render nothing. The URL is dynamic on
  *  both `[slug]` (blueprint route, e.g. `projects`/`resources`/
- *  `entities`) and `[itemSlug]` (the record slug), so a single page
+ *  `entities`) and `[recordSlug]` (the record slug), so a single page
  *  file serves every blueprint and every record.
  */
 import siteConfig from "../../../data/generated/site-config.json";
@@ -54,12 +54,12 @@ export async function getStaticPaths() {
     /* not present */
   }
   return fullRecords.map((record) => ({
-    params: { slug: dirSlug, itemSlug: record.slug },
+    params: { slug: dirSlug, recordSlug: record.slug },
   }));
 }
 
 const slug = Astro.params.slug ?? indexSlug();
-const recordSlug = Astro.params.itemSlug ?? "";
+const recordSlug = Astro.params.recordSlug ?? "";
 const project = projectBySlug(recordSlug);
 const resource = resourceBySlug(recordSlug);
 const entity = entityBySlug(recordSlug);
@@ -162,20 +162,51 @@ const languages = extras.github?.languages
 const totalLanguageBytes = Math.max(1, languages.reduce((sum, [, b]) => sum + b, 0));
 
 // ── Kind-aware JSON-LD ─────────────────────────────────────────
+// Mirrors the openapps field set (10+ fields for projects):
+//   name, headline, description, url, codeRepository, sameAs,
+//   programmingLanguage, license, applicationCategory,
+//   operatingSystem, keywords, dateCreated, dateModified,
+//   interactionStatistic, author, isAccessibleForFree.
 let jsonLd: Record<string, unknown>;
 if (isProject && proj) {
+  const sameAs = [repoUrl, homepageUrl].filter((value): value is string =>
+    typeof value === "string" && value.length > 0,
+  );
+  const keywords = (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined;
+  const operatingSystem = (proj.platforms ?? []).length > 0
+    ? (proj.platforms ?? []).join(", ")
+    : undefined;
+  const applicationCategory = (record.category ?? "") || undefined;
+  const dateCreated = (record as { curation?: { reviewedAt?: string } }).curation?.reviewedAt;
+  const dateModified = pushedAt ?? dateCreated;
+  const interactionStatistic = stars > 0
+    ? {
+        "@type": "InteractionCounter",
+        interactionType: { "@type": "LikeAction" },
+        userInteractionCount: stars,
+      }
+    : undefined;
   jsonLd = {
     "@context": "https://schema.org",
     "@type": "SoftwareSourceCode",
     name,
+    headline: name,
     description: record.description ?? undefined,
     url: repoUrl || homepageUrl || undefined,
     codeRepository: repoUrl || undefined,
+    sameAs: sameAs.length > 0 ? sameAs : undefined,
     programmingLanguage: language ?? undefined,
     license: licenseSpdx ?? undefined,
+    applicationCategory,
+    operatingSystem,
+    keywords,
+    dateCreated: dateCreated ?? undefined,
+    dateModified: dateModified ?? undefined,
+    interactionStatistic,
     author: ownerRepo
       ? { "@type": "Organization", name: ownerRepo.owner, url: `https://github.com/${ownerRepo.owner}` }
       : undefined,
+    isAccessibleForFree: true,
   };
 } else if (record.kind === "resource") {
   const resourceSchemaType: Record<string, string> = {
@@ -189,20 +220,25 @@ if (isProject && proj) {
     "@context": "https://schema.org",
     "@type": resourceSchemaType[record.type] ?? "CreativeWork",
     name,
+    headline: name,
     description: record.description || undefined,
     url: homepageUrl || undefined,
     author: record.author ? { "@type": "Person", name: record.author } : undefined,
     datePublished: record.publishedAt || undefined,
+    keywords: (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined,
+    isAccessibleForFree: true,
   };
 } else {
   jsonLd = {
     "@context": "https://schema.org",
     "@type": record.type === "person" ? "Person" : "Organization",
     name,
+    headline: name,
     description: record.description || undefined,
     url: homepageUrl || undefined,
     foundingDate: record.founded || undefined,
     location: record.location || undefined,
+    keywords: (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined,
   };
 }
 ---
@@ -264,6 +300,17 @@ if (isProject && proj) {
                 {labelDisplay(l) ?? prettySlug(l)}
               </span>
             ))}
+            {record.curation?.reviewed && (
+              <span
+                class="inline-flex items-center gap-1 rounded border border-emerald-300/60 bg-emerald-50 px-1.5 py-0.5 text-[10px] font-medium text-emerald-800 dark:border-emerald-800/60 dark:bg-emerald-950/40 dark:text-emerald-300"
+                title="A human curator reviewed this record. (No reviewer name is shown — the framework is reviewer-agnostic; consumers can wire the curation.by field into their own badge component.)"
+              >
+                <svg viewBox="0 0 16 16" width="10" height="10" aria-hidden="true" fill="currentColor">
+                  <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0Zm3.41 5.09a.75.75 0 0 0-1.06 0L6.75 8.69 5.65 7.59a.75.75 0 1 0-1.06 1.06l1.65 1.65a.75.75 0 0 0 1.06 0l4.11-4.11a.75.75 0 0 0 0-1.06Z" />
+                </svg>
+                Curator reviewed
+              </span>
+            )}
             {healthLabel && (
               <span class="grove-badge grove-badge-stale">{healthLabel}</span>
             )}

package/templates/default/src/pages/[slug]/index.astro

@@ -5,7 +5,8 @@
  * Mirrors the openapps list structure:
  *   - SmartLensTabs (All / Trending / Recently added / Established / Featured)
  *   - RefinePanel  (Stack / Platform / Category / License / Sort)
- *   - ItemSection rows (full record cards via RecordSection)
+ *   - RecordSection rows (full record cards; the `ItemSection` V0
+ *     name was renamed to `RecordSection` in V1)
  *   - ExploreByCategory / ExploreByStack (compact pill lists)
  *
  * Generic: the URL slug (e.g. `/projects/`, `/resources/`,
@@ -15,11 +16,12 @@
  */
 import siteConfig from "../../../data/generated/site-config.json";
 import { items, itemLabel, itemLabelPlural } from "../../data/records";
-import type { AppsFilters } from "@grove-dev/astro";
+import type { IndexFilters } from "@grove-dev/astro";
 import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
 import SmartLensTabs from "@grove-dev/astro/components/SmartLensTabs.astro";
 import RefinePanel from "@grove-dev/astro/components/RefinePanel.astro";
-import AppsIndexRow from "@grove-dev/astro/components/AppsIndexRow.astro";
+import IndexRow from "@grove-dev/astro/components/IndexRow.astro";
+import Pagination from "@grove-dev/astro/components/Pagination.astro";
 import ExploreByCategory from "@grove-dev/astro/components/ExploreByCategory.astro";
 import ExploreByStack from "@grove-dev/astro/components/ExploreByStack.astro";
 import {
@@ -30,11 +32,12 @@ import {
   countByStack,
   effectivePage,
   effectiveSort,
-  filterApps,
+  filterRecords,
   filtersFromSearchParams,
   paginate,
   searchParamsFromFilters,
   sortDisplay,
+  SORT_OPTIONS,
   totalPages,
 } from "@grove-dev/astro";
 
@@ -57,7 +60,7 @@ const filters = filtersFromSearchParams(Astro.url.searchParams);
 const facets = buildFacets(items);
 const sort = effectiveSort(filters);
 const requestedPage = effectivePage(filters);
-const filtered = filterApps(items, filters);
+const filtered = filterRecords(items, filters);
 const sorted = applySort(filtered, sort);
 const pages = totalPages(sorted.length);
 const page = Math.min(requestedPage, pages);
@@ -106,15 +109,15 @@ const stackEntries = [...countByStack(items as Parameters<typeof countByStack>[0
   .map(([name, count]) => ({ name, slug: name, count }));
 
 function hrefForPage(target: number): string {
-  const next: AppsFilters = { ...filters, page: target };
+  const next: IndexFilters = { ...filters, page: target };
   const query = searchParamsFromFilters(next).toString();
   return query ? `/${slug}?${query}` : `/${slug}`;
 }
 
-function hrefForRemove(key: keyof AppsFilters, value: string): string {
-  const params = new URLSearchParams(Astro.url.searchParams);
-  params.delete("page");
-  const urlKey: Partial<Record<keyof AppsFilters, string>> = {
+function hrefForRemove(key: keyof IndexFilters, value: string): string {
+  const params = new URLSearchParams();
+  const next: IndexFilters = { ...filters, page: 1 };
+  const urlKey: Partial<Record<keyof IndexFilters, string>> = {
     stacks: "stack",
     platforms: "platform",
     categories: "category",
@@ -164,6 +167,7 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
       <form
         method="get"
         action={`/${slug}`}
+        id="search-form"
         class="mt-6 flex flex-col gap-2 sm:flex-row"
         role="search"
       >
@@ -177,9 +181,10 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
             class="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-ink-400"
             fill="currentColor"
           >
-            <path d="M10.68 11.74a6 6 0 0 1-7.922-8.982 6 6 0 0 1 8.982 7.922l3.04 3.04a.75.75 0 0 1-1.06 1.06l-3.04-3.04ZM11.5 7a4.5 4.5 0 1 0-9 0 4.5 4.5 0 0 0 9 0Z" />
+            <path d="M10.68 11.74a6 6 0 0 1-7.922-8.982 6 6 0 0 1 8.982 7.922l3.04 3.04a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215ZM11.5 7a4.5 4.5 0 1 0-9 0 4.5 4.5 0 0 0 9 0Z" />
           </svg>
           <input
+            id="search-input"
             type="search"
             name="q"
             value={filters.q ?? ""}
@@ -187,7 +192,28 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
             class="h-10 w-full rounded-md border border-ink-200 bg-white py-2 pl-9 pr-3 text-sm text-ink-900 placeholder:text-ink-400 focus:border-ink-900 focus:outline-none focus:ring-2 focus:ring-ink-900/10 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-100"
           />
         </label>
-        {filters.sort && <input type="hidden" name="sort" value={filters.sort} />}
+        <label class="relative">
+          <span class="sr-only">{`Sort ${itemLabelPlural()}`}</span>
+          <select
+            id="sort-select"
+            name="sort"
+            class="h-10 cursor-pointer appearance-none rounded-md border border-ink-200 bg-white py-1.5 pl-3 pr-8 text-sm font-medium text-ink-700 transition-colors hover:border-ink-300 focus:border-ink-900 focus:outline-none focus:ring-2 focus:ring-ink-900/10 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-300 dark:hover:border-ink-700 dark:focus:border-ink-100 dark:focus:ring-ink-100/15"
+          >
+            {SORT_OPTIONS.map((o) => (
+              <option value={o.value} selected={o.value === sort}>{o.label}</option>
+            ))}
+          </select>
+          <svg
+            viewBox="0 0 16 16"
+            width="11"
+            height="11"
+            aria-hidden="true"
+            class="pointer-events-none absolute right-2.5 top-1/2 -translate-y-1/2 text-ink-400"
+            fill="currentColor"
+          >
+            <path d="M4.22 6.22a.75.75 0 0 1 1.06 0L8 8.94l2.72-2.72a.75.75 0 1 1 1.06 1.06l-3.25 3.25a.75.75 0 0 1-1.06 0L4.22 7.28a.75.75 0 0 1 0-1.06Z" />
+          </svg>
+        </label>
         <button type="submit" class="grove-btn grove-btn-primary">Search</button>
       </form>
 
@@ -266,8 +292,8 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
 
       <ul id="results-list" class="m-0 flex list-none flex-col gap-3 p-0">
         {sorted.map((item) => (
-            <li class="m-0 p-0" data-item-slug={item.slug}>
-              <AppsIndexRow record={item as Parameters<typeof AppsIndexRow>[0]["record"]} detailHref={`/${slug}/${item.slug}`} />
+            <li class="m-0 p-0" data-record-slug={item.slug}>
+              <IndexRow record={item as Parameters<typeof IndexRow>[0]["record"]} detailHref={`/${slug}/${item.slug}`} />
             </li>
         ))}
       </ul>
@@ -277,7 +303,28 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
         </p>
         <a href={`/${slug}`} class="grove-btn grove-btn-outline mt-4">Clear filters</a>
       </div>
-      <nav id="client-pagination" class="mt-8 flex flex-wrap items-center justify-center gap-1.5" aria-label="Pagination"></nav>
+      <nav class="mt-8 flex flex-wrap items-center justify-center gap-1.5" aria-label="Pagination">
+        <Pagination current={page} total={pages} hrefFor={hrefForPage} />
+      </nav>
+    </div>
+  </section>
+
+  <section class="border-t border-ink-200 dark:border-ink-800">
+    <div class="grove-container-wide mx-auto px-5 sm:px-7">
+      <div class="flex flex-col items-center gap-3 py-12 text-center">
+        <h2 class="m-0 text-xl font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          {`Know a real ${itemLabel()} that belongs here?`}
+        </h2>
+        <p class="m-0 max-w-2xl text-sm text-ink-500 dark:text-ink-400">
+          {`Open a pull request with a YAML file. We review every submission against the bar — no marketing, no tutorials.`}
+        </p>
+        <a
+          href={siteConfig.submitUrl ?? "/submit"}
+          class="grove-btn grove-btn-primary mt-2"
+        >
+          {`Submit ${itemLabel()}`}
+        </a>
+      </div>
     </div>
   </section>
 
@@ -287,6 +334,49 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
       var list = document.getElementById("results-list");
       if (!list) return;
 
+      // Sort dropdown: navigate on change so the server re-renders
+      // the sorted list (URL is the source of truth for filters/sort).
+      var sortSelect = document.getElementById("sort-select");
+      if (sortSelect) {
+        sortSelect.addEventListener("change", function () {
+          var params = new URLSearchParams(location.search);
+          if (sortSelect.value && sortSelect.value !== "recently-updated") {
+            params.set("sort", sortSelect.value);
+          } else {
+            params.delete("sort");
+          }
+          params.delete("page");
+          var qs = params.toString();
+          location.assign(qs ? "?" + qs : location.pathname);
+        });
+      }
+
+      // Search: 250ms debounce; pressing Enter still submits
+      // immediately via the form's normal submit handler.
+      var searchInput = document.getElementById("search-input");
+      var searchForm = document.getElementById("search-form");
+      if (searchInput && searchForm) {
+        var debounceTimer = null;
+        var submit = function () {
+          var params = new URLSearchParams(location.search);
+          var term = searchInput.value.trim();
+          if (term) params.set("q", term);
+          else params.delete("q");
+          params.delete("page");
+          var qs = params.toString();
+          location.assign(qs ? "?" + qs : location.pathname);
+        };
+        searchInput.addEventListener("input", function () {
+          if (debounceTimer) window.clearTimeout(debounceTimer);
+          debounceTimer = window.setTimeout(submit, 250);
+        });
+        searchForm.addEventListener("submit", function (event) {
+          event.preventDefault();
+          if (debounceTimer) window.clearTimeout(debounceTimer);
+          submit();
+        });
+      }
+
       function values(params, key) {
         return params.getAll(key).filter(Boolean);
       }
@@ -369,11 +459,11 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
         var order = new Map(filtered.map(function (item, index) { return [item.slug, index]; }));
         Array.from(list.children)
           .sort(function (a, b) {
-            return (order.get(a.dataset.itemSlug) ?? Number.MAX_SAFE_INTEGER) -
-              (order.get(b.dataset.itemSlug) ?? Number.MAX_SAFE_INTEGER);
+            return (order.get(a.dataset.recordSlug) ?? Number.MAX_SAFE_INTEGER) -
+              (order.get(b.dataset.recordSlug) ?? Number.MAX_SAFE_INTEGER);
           })
           .forEach(function (node) {
-            node.hidden = !visible.has(node.dataset.itemSlug);
+            node.hidden = !visible.has(node.dataset.recordSlug);
             list.appendChild(node);
           });
 
@@ -395,21 +485,9 @@ function hrefForRemove(key: keyof AppsFilters, value: string): string {
           });
         });
 
-        var pager = document.getElementById("client-pagination");
-        if (pager) {
-          pager.innerHTML = "";
-          if (totalPages > 1) {
-            for (var number = 1; number <= totalPages; number += 1) {
-              var link = document.createElement("a");
-              link.href = pageHref(params, number);
-              link.textContent = String(number);
-              link.className = "grove-btn min-w-9 px-2 py-1.5 text-2xs " +
-                (number === page ? "grove-btn-primary" : "grove-btn-outline");
-              if (number === page) link.setAttribute("aria-current", "page");
-              pager.appendChild(link);
-            }
-          }
-        }
+        // Pagination is server-rendered (see <Pagination /> in the
+        // template) so the static HTML contains the page-number
+        // links for SEO. No client-side rendering loop here.
 
         var chipHost = document.getElementById("active-filters");
         if (chipHost) {

package/templates/default/src/pages/apps/[recordSlug].astro

@@ -0,0 +1,33 @@
+---
+/**
+ * /apps/<slug> — V0-published alias URL → V1 canonical.
+ *
+ * The canonical V1 detail URL is `/<blueprint>/<recordSlug>` (e.g.
+ * `/projects/coolify`). The V0 published Astro template exposed
+ * `/apps/<slug>` as a static alias to keep the openapps-style URL
+ * working for project-directory blueprints. Now that the V1
+ * template uses the blueprint-aware dynamic route everywhere,
+ * this page is a pure redirect: any `/apps/<slug>` request is
+ * sent to the blueprint-canonical path.
+ */
+import { indexSlug, fullRecords, projectBySlug, recordBySlug } from "../../data/records";
+
+export async function getStaticPaths() {
+  return fullRecords.map((r) => ({ params: { recordSlug: r.slug } }));
+}
+
+const slug = indexSlug();
+const recordSlug = Astro.params.recordSlug ?? "";
+
+if (slug !== "projects") {
+  return Astro.redirect(`/${slug}/${recordSlug}`);
+}
+
+const record = recordBySlug(recordSlug);
+if (!record) {
+  return Astro.redirect(`/${slug}`);
+}
+
+// Canonical V1 URL.
+return Astro.redirect(`/${slug}/${recordSlug}`, 301);
+---