@wix/agent-skills 1.26.0 → 1.27.0

package/skills/wix-headless-templates/portfolio/app/wix/portfolio/types.ts

@@ -0,0 +1,55 @@
+// Portfolio DTOs — the serializable shapes every hook, component, and page consumes.
+// Plain JSON: safe as Astro island props or across server/client boundaries. Images are
+// resolved https URLs; videos are playable mp4 URLs with a poster frame.
+
+/** A collection as the gallery grid needs it. */
+export interface CollectionSummary {
+  id: string;
+  slug: string;
+  title: string;
+  description: string;
+  /** Resolved https URL ("" when the collection has no cover). */
+  imageUrl: string;
+}
+
+/** A project as a grid tile needs it. */
+export interface ProjectSummary {
+  id: string;
+  slug: string;
+  title: string;
+  description: string;
+  /** Cover image; a video-covered project falls back to its poster frame ("" when neither). */
+  imageUrl: string;
+  /** The collections this project belongs to (a project can be in several). */
+  collectionIds: string[];
+}
+
+/** One row of a project's metadata (Role, Year, Client…): plain text or an outbound link. */
+export interface ProjectDetailRow {
+  label: string;
+  text: string;
+  /** Non-null → render the row's text as a link. */
+  url: string | null;
+  /** Link rows only: "_blank" | "_self". */
+  target: string | null;
+}
+
+/** A project as the detail page needs it. */
+export interface ProjectDetail extends ProjectSummary {
+  details: ProjectDetailRow[];
+}
+
+/** One media item of a project's gallery (dashboard order). */
+export interface GalleryItem {
+  id: string;
+  kind: "image" | "video";
+  title: string;
+  description: string;
+  /** image: the resolved image. video: the poster frame ("" when the video has none). */
+  imageUrl: string;
+  /** video only: playable mp4 URL. */
+  videoUrl: string | null;
+  /** Optional owner-attached outbound link for this item. */
+  linkUrl: string | null;
+  linkTarget: string | null;
+}

package/skills/wix-headless-templates/portfolio/app-astro/layouts/SiteLayout.astro

@@ -0,0 +1,40 @@
+---
+// The site chrome for every portfolio page — THIS file (header/footer/nav) plus the @theme
+// token block in src/styles/global.css are what you brand. Keep the <slot name="seo-tags" />
+// in <head> and the global.css import. (Deploy is fill-only: if another vertical is already
+// deployed, its SiteLayout won — merge a Portfolio nav link there instead.)
+import "../styles/global.css";
+
+interface Props {
+  title: string;
+  description?: string;
+}
+const { title, description } = Astro.props;
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{title}</title>
+    {description && <meta name="description" content={description} />}
+    <slot name="seo-tags" />
+  </head>
+  <body>
+    <header class="sticky top-0 z-40 border-b border-border bg-background/80 backdrop-blur">
+      <div class="mx-auto flex h-16 max-w-6xl items-center justify-between px-6">
+        <a href="/" class="text-base font-bold tracking-tight text-foreground no-underline">Brand Name</a>
+        <nav class="flex items-center gap-6 text-sm">
+          <a href="/portfolio" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Portfolio</a>
+        </nav>
+      </div>
+    </header>
+    <main class="mx-auto max-w-6xl px-6 pb-24 pt-10">
+      <slot />
+    </main>
+    <footer class="border-t border-border px-6 py-10 text-center text-sm text-muted-foreground">
+      © Brand Name
+    </footer>
+  </body>
+</html>

package/skills/wix-headless-templates/portfolio/app-astro/pages/portfolio/[slug].astro

@@ -0,0 +1,30 @@
+---
+// Collection page — header + its projects, resolved by slug SERVER-SIDE.
+// Portfolio has no documented Wix SEO item type, so this page carries plain
+// <title>/<meta description> from the DTO (no wixMetadata / <SEO.Tags> — unlike
+// storefront/bookings item pages). Keep the frontmatter; swap the island import to YOUR
+// collection-page component.
+import SiteLayout from "../../layouts/SiteLayout.astro";
+import CollectionProjectsView from "../../components/portfolio/CollectionProjectsView";
+import { fetchCollectionBySlug, fetchProjects } from "../../wix/portfolio/portfolio";
+import type { CollectionSummary, ProjectSummary } from "../../wix/portfolio/types";
+
+const slug = Astro.params.slug!;
+
+let collection: CollectionSummary | null = null;
+let projects: ProjectSummary[] = [];
+try {
+  collection = await fetchCollectionBySlug(slug);
+  if (collection) projects = await fetchProjects({ collectionId: collection.id });
+} catch {
+  // Guarded: an unhandled SSR throw truncates the response mid-stream.
+}
+
+if (!collection) {
+  return new Response(null, { status: 404 });
+}
+---
+
+<SiteLayout title={collection.title} description={collection.description}>
+  <CollectionProjectsView client:load slug={slug} initialCollection={collection} initialProjects={projects} />
+</SiteLayout>

package/skills/wix-headless-templates/portfolio/app-astro/pages/portfolio.astro

@@ -0,0 +1,21 @@
+---
+// Collections gallery — data fetched SERVER-SIDE (SEO) and handed to the island as DTO props.
+// Keep this frontmatter; swap the island import to YOUR gallery component.
+import SiteLayout from "../layouts/SiteLayout.astro";
+import CollectionsView from "../components/portfolio/CollectionsView";
+import { fetchCollections } from "../wix/portfolio/portfolio";
+import type { CollectionSummary } from "../wix/portfolio/types";
+
+let collections: CollectionSummary[] = [];
+try {
+  collections = await fetchCollections();
+} catch {
+  // An unguarded SSR throw truncates the response mid-stream; the island renders the
+  // empty state instead.
+}
+---
+
+<SiteLayout title="Portfolio">
+  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Portfolio</h1>
+  <CollectionsView client:load initialCollections={collections} />
+</SiteLayout>

package/skills/wix-headless-templates/portfolio/app-astro/pages/projects/[slug].astro

@@ -0,0 +1,29 @@
+---
+// Project detail page — project + media gallery, resolved by slug SERVER-SIDE.
+// Portfolio has no documented Wix SEO item type, so this page carries plain
+// <title>/<meta description> from the DTO (no wixMetadata / <SEO.Tags>). Keep the
+// frontmatter; swap the island import to YOUR detail component.
+import SiteLayout from "../../layouts/SiteLayout.astro";
+import ProjectDetailView from "../../components/portfolio/ProjectDetailView";
+import { fetchProjectBySlug, fetchProjectGallery } from "../../wix/portfolio/portfolio";
+import type { GalleryItem, ProjectDetail } from "../../wix/portfolio/types";
+
+const slug = Astro.params.slug!;
+
+let project: ProjectDetail | null = null;
+let items: GalleryItem[] = [];
+try {
+  project = await fetchProjectBySlug(slug);
+  if (project) items = await fetchProjectGallery(project.id);
+} catch {
+  // Guarded: an unhandled SSR throw truncates the response mid-stream.
+}
+
+if (!project) {
+  return new Response(null, { status: 404 });
+}
+---
+
+<SiteLayout title={project.title} description={project.description}>
+  <ProjectDetailView client:load slug={slug} initialProject={project} initialItems={items} />
+</SiteLayout>

package/skills/wix-headless-templates/portfolio/project/README.md

@@ -0,0 +1,15 @@
+# Wix Astro Blank Template
+
+**[Live demo](https://h6s-1a31f9730cd85b-headlessstack.wix-site-host.com)**
+
+Our Astro templates are still in development and subject to change.
+
+To use a template, follow the [Wix CLI for Headless Quick Start](https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-with-the-wix-cli), and select the desired template during the setup process.
+
+## Need help?
+
+For documentation and support, check out:
+
+- [Wix Headless Documentation](https://dev.wix.com/docs/go-headless)
+- [Wix SDK Documentation](https://dev.wix.com/docs/sdk)
+- [Community on Discord](https://discord.gg/n6TBrSnYTp)

package/skills/wix-headless-templates/portfolio/project/astro.config.mjs

@@ -0,0 +1,22 @@
+import tailwindcss from "@tailwindcss/vite";
+// @ts-check
+import { defineConfig } from 'astro/config';
+import wix from "@wix/astro";
+import wixPages from "@wix/astro-pages";
+
+import react from "@astrojs/react";
+import wixHostingAdapter from "@wix/astro-wix-hosting-adapter";
+
+// https://astro.build/config
+export default defineConfig({
+  vite: { plugins: [tailwindcss()] },
+  integrations: [wix(), wixPages(), react()],
+  security: { checkOrigin: false },
+  adapter: wixHostingAdapter(),
+
+  image: {
+    domains: ["static.wixstatic.com"],
+  },
+
+  output: "server",
+});