create-nymbal-app 0.3.0 → 0.5.0

package/scaffold/templates/astro/src/styles/pages/pdp.css

@@ -24,38 +24,7 @@
   }
 }
 
-/* ---- Breadcrumbs ---- */
-
-.pdp-breadcrumbs {
-  display: flex;
-  align-items: center;
-  gap: var(--nymbal-spacing-xs, 0.25rem);
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  flex-wrap: wrap;
-}
-
-.pdp-breadcrumbs a {
-  color: var(--nymbal-color-text-muted, #71717a);
-  text-decoration: none;
-  transition: color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.pdp-breadcrumbs a:hover {
-  color: var(--nymbal-color-accent, #2563eb);
-}
-
-.pdp-breadcrumbs .separator {
-  color: var(--nymbal-color-border, #e4e4e7);
-}
-
-.pdp-breadcrumbs .current {
-  color: var(--nymbal-color-text, #18181b);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-}
-
-/* ---- Image gallery ---- */
+/* ---- Image gallery (nymbal-image-gallery) ---- */
 
 .pdp-gallery {
   position: sticky;
@@ -63,50 +32,6 @@
   align-self: start;
 }
 
-.pdp-main-image {
-  width: 100%;
-  aspect-ratio: 1 / 1;
-  object-fit: cover;
-  border-radius: var(--nymbal-radius-lg, 0.75rem);
-  background-color: #f4f4f5;
-  margin-bottom: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.pdp-thumbnails {
-  display: flex;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  overflow-x: auto;
-  scrollbar-width: thin;
-  padding-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.pdp-thumbnail {
-  width: 64px;
-  height: 64px;
-  object-fit: cover;
-  border-radius: var(--nymbal-radius-md, 0.5rem);
-  border: 2px solid transparent;
-  cursor: pointer;
-  flex-shrink: 0;
-  background-color: #f4f4f5;
-  transition: border-color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.pdp-thumbnail:hover {
-  border-color: var(--nymbal-color-border, #e4e4e7);
-}
-
-.pdp-thumbnail.active {
-  border-color: var(--nymbal-color-primary, #18181b);
-}
-
-@media (min-width: 641px) {
-  .pdp-thumbnail {
-    width: 80px;
-    height: 80px;
-  }
-}
-
 /* ---- Product info ---- */
 
 .pdp-info {
@@ -128,42 +53,6 @@
   }
 }
 
-.pdp-price {
-  font-size: 1.5rem;
-  font-weight: var(--nymbal-font-weight-bold, 700);
-  color: var(--nymbal-color-primary, #18181b);
-}
-
-.pdp-price-range {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-weight: var(--nymbal-font-weight-normal, 400);
-  margin-left: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.pdp-stock {
-  display: inline-flex;
-  align-items: center;
-  gap: var(--nymbal-spacing-xs, 0.25rem);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-}
-
-.pdp-stock.in-stock {
-  color: var(--nymbal-color-success, #16a34a);
-}
-
-.pdp-stock.out-of-stock {
-  color: var(--nymbal-color-error, #dc2626);
-}
-
-.pdp-stock-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: var(--nymbal-radius-full, 9999px);
-  background-color: currentColor;
-}
-
 .pdp-description {
   font-size: var(--nymbal-font-size-sm, 0.875rem);
   color: var(--nymbal-color-text-muted, #71717a);
@@ -214,59 +103,8 @@ nymbal-add-to-cart {
   margin-bottom: var(--nymbal-spacing-lg, 1.5rem);
 }
 
-.review-list {
-  display: flex;
-  flex-direction: column;
-  gap: var(--nymbal-spacing-lg, 1.5rem);
-}
-
-.review-item {
-  padding-bottom: var(--nymbal-spacing-lg, 1.5rem);
-  border-bottom: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.review-item:last-child {
-  border-bottom: none;
-  padding-bottom: 0;
-}
-
-.review-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-  flex-wrap: wrap;
-}
-
-.review-rating {
-  display: flex;
-  gap: 2px;
-  color: var(--nymbal-color-warning, #d97706);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-}
-
-.review-date {
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.review-title {
-  font-size: var(--nymbal-font-size-base, 1rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.review-body {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  line-height: 1.6;
-}
-
-.reviews-empty {
-  text-align: center;
-  padding: var(--nymbal-spacing-xl, 2rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
+.pdp-review-form {
+  margin-top: var(--nymbal-spacing-xl, 2rem);
+  padding-top: var(--nymbal-spacing-xl, 2rem);
+  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
 }

package/scaffold/templates/astro/src/styles/pages/plp.css

@@ -30,11 +30,6 @@
   margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
 }
 
-.plp-count {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
 /* ---- Filter sidebar ---- */
 
 .plp-sidebar {
@@ -91,7 +86,7 @@
   margin-bottom: 0;
 }
 
-.filter-item input[type="checkbox"] {
+.filter-item input[type='checkbox'] {
   width: 16px;
   height: 16px;
   accent-color: var(--nymbal-color-accent, #2563eb);
@@ -108,11 +103,11 @@
 }
 
 .filter-link:hover,
-.filter-link[aria-current="page"] {
+.filter-link[aria-current='page'] {
   color: var(--nymbal-color-accent, #2563eb);
 }
 
-.filter-link[aria-current="page"] {
+.filter-link[aria-current='page'] {
   font-weight: var(--nymbal-font-weight-bold, 700);
 }
 
@@ -171,40 +166,6 @@
   min-width: 0;
 }
 
-/* ---- Pagination ---- */
-
-.plp-pagination {
-  display: flex;
-  justify-content: center;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-top: var(--nymbal-spacing-xl, 2rem);
-  padding-top: var(--nymbal-spacing-lg, 1.5rem);
-  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.plp-pagination .btn {
-  min-width: 100px;
-}
-
-/* ---- Empty state ---- */
-
-.plp-empty {
-  text-align: center;
-  padding: 4rem var(--nymbal-spacing-md, 1rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.plp-empty-title {
-  font-size: var(--nymbal-font-size-lg, 1.125rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.plp-empty-text {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-}
-
 /* ---- nymbal-product-filter integration ---- */
 
 nymbal-product-filter {

package/scaffold/templates/astro/src/styles/pages/search.css

@@ -44,109 +44,22 @@
   box-shadow: 0 0 0 4px rgba(37, 99, 235, 0.12);
 }
 
-/* ---- Results area ---- */
+/* ---- Category filter beside the results ---- */
 
-.search-results {
-  padding-top: var(--nymbal-spacing-lg, 1.5rem);
+.search-layout {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: var(--nymbal-spacing-lg, 1.5rem);
 }
 
-.search-results-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  flex-wrap: wrap;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.search-query-label {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.search-query-label strong {
-  color: var(--nymbal-color-text, #18181b);
-  font-weight: var(--nymbal-font-weight-bold, 700);
-}
-
-.search-result-count {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-/* ---- Results grid (uses .product-grid from global) ---- */
-
-/* ---- Empty / no results ---- */
-
-.search-empty {
-  text-align: center;
-  padding: 4rem var(--nymbal-spacing-md, 1rem);
-}
-
-.search-empty-icon {
-  font-size: 3rem;
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  opacity: 0.3;
-}
-
-.search-empty-title {
-  font-size: var(--nymbal-font-size-lg, 1.125rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
+/* The filter carries `empty` when the search has no facets: the results take the width. The page serves it with
+   `empty`, so no sidebar column is drawn before the element runs. */
+@media (min-width: 769px) {
+  .search-layout:has(nymbal-product-filter:not([empty])) {
+    grid-template-columns: 240px minmax(0, 1fr);
+  }
 }
 
-.search-empty-text {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  max-width: 28ch;
-  margin-inline: auto;
-}
-
-/* ---- Suggestions ---- */
-
-.search-suggestions {
-  margin-top: var(--nymbal-spacing-lg, 1.5rem);
-}
-
-.search-suggestions-title {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.search-suggestions-list {
-  display: flex;
-  flex-wrap: wrap;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.search-suggestion {
-  display: inline-flex;
-  padding: var(--nymbal-spacing-xs, 0.25rem) var(--nymbal-spacing-md, 1rem);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text, #18181b);
-  background-color: var(--nymbal-color-surface, #fff);
-  border: 1px solid var(--nymbal-color-border, #e4e4e7);
-  border-radius: var(--nymbal-radius-full, 9999px);
-  text-decoration: none;
-  transition: border-color var(--nymbal-transition-fast, 150ms) ease,
-    background-color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.search-suggestion:hover {
-  border-color: var(--nymbal-color-accent, #2563eb);
-  background-color: rgba(37, 99, 235, 0.04);
-}
-
-/* ---- Loading ---- */
-
-.search-loading {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  padding: 3rem;
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
+.search-sidebar:has(nymbal-product-filter[empty]) {
+  display: none;
 }

package/scaffold/templates/astro/src/styles/tokens.css

@@ -0,0 +1,56 @@
+/* ----------------------------------------------------------------
+   Design tokens: this store's file, edit it to restyle.
+   Every Nymbal element reads its look from these custom properties,
+   which cross into its shadow root. An element's `part`s can be
+   styled further with ::part(), e.g. nymbal-add-to-cart::part(button).
+   Defaults: @nymbalhq/web-components/tokens.css.
+   ---------------------------------------------------------------- */
+
+:root {
+  --nymbal-color-primary: #18181b;
+  --nymbal-color-primary-hover: #27272a;
+  --nymbal-color-accent: #2563eb;
+  --nymbal-color-accent-hover: #1d4ed8;
+  --nymbal-color-success: #16a34a;
+  --nymbal-color-error: #dc2626;
+  --nymbal-color-warning: #d97706;
+  --nymbal-color-text: #18181b;
+  --nymbal-color-text-muted: #71717a;
+  --nymbal-color-text-inverse: #ffffff;
+  --nymbal-color-border: #e4e4e7;
+  --nymbal-color-surface: #ffffff;
+  --nymbal-color-overlay: rgba(0, 0, 0, 0.4);
+
+  --nymbal-font-family: system-ui, -apple-system, sans-serif;
+  --nymbal-font-size-xs: 0.75rem;
+  --nymbal-font-size-sm: 0.875rem;
+  --nymbal-font-size-base: 1rem;
+  --nymbal-font-size-lg: 1.125rem;
+  --nymbal-font-size-xl: 1.25rem;
+  --nymbal-font-weight-normal: 400;
+  --nymbal-font-weight-medium: 500;
+  --nymbal-font-weight-bold: 700;
+
+  --nymbal-spacing-xs: 0.25rem;
+  --nymbal-spacing-sm: 0.5rem;
+  --nymbal-spacing-md: 1rem;
+  --nymbal-spacing-lg: 1.5rem;
+  --nymbal-spacing-xl: 2rem;
+
+  --nymbal-radius-sm: 0.25rem;
+  --nymbal-radius-md: 0.375rem;
+  --nymbal-radius-lg: 0.5rem;
+  --nymbal-radius-full: 9999px;
+
+  --nymbal-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
+  --nymbal-shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
+  --nymbal-shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
+
+  --nymbal-transition-fast: 150ms ease;
+  --nymbal-transition-normal: 200ms ease;
+  --nymbal-transition-slow: 300ms ease;
+
+  --nymbal-z-dropdown: 100;
+  --nymbal-z-drawer: 200;
+  --nymbal-z-toast: 300;
+}

package/scaffold/templates/nextjs/_dot.node-version

@@ -1 +1 @@
-22.23.3
+26.12.1

package/scaffold/templates/nextjs/app/(catalog)/category/[slug]/page.tsx

@@ -0,0 +1,74 @@
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+import { fetchProducts, fetchCategories, fetchCapabilities, sortFromSearchParams } from '@/lib/api'
+import { cardImageOf, cardProductOf, renderNymbal } from '@/lib/render'
+import { Breadcrumb, ProductGrid } from '@/components/client/elements'
+import { ListingControls } from '@/components/client/ListingControls'
+import styles from '@/styles/pages/plp.module.css'
+
+interface CategoryPageProps {
+  params: Promise<{ slug: string }>
+  searchParams: Promise<{ sort?: string | string[] }>
+}
+
+export async function generateMetadata({ params }: CategoryPageProps): Promise<Metadata> {
+  const { slug } = await params
+  const categories = await fetchCategories()
+  const category = categories.find((c) => c.slug === slug)
+
+  return {
+    title: category?.name ?? slug,
+    description: category?.description ?? `Browse products in ${slug}.`,
+  }
+}
+
+export default async function CategoryPage({ params, searchParams }: CategoryPageProps) {
+  const { slug } = await params
+  const capabilities = await fetchCapabilities()
+  const sort = sortFromSearchParams(await searchParams, capabilities?.catalog)
+  const [{ items, nextCursor, facets }, categories] = await Promise.all([
+    fetchProducts({ limit: 24, category: slug, sort }),
+    fetchCategories(),
+  ])
+
+  const category = categories.find((c) => c.slug === slug)
+  if (!category) notFound()
+  const crumbs = [{ label: 'Home', href: '/' }, { label: category.name }]
+  const cards = items.map(cardProductOf)
+  // The first card's image is the page's LCP, and the preload scanner never reaches it inside the grid's shadow root:
+  // a preload link, which React hoists into the head, starts it.
+  const firstImage = cards[0] === undefined ? null : cardImageOf(cards[0]).url
+  const grid = {
+    products: JSON.stringify(cards),
+    source: 'product-list',
+    ...(nextCursor !== null && { 'has-more': '' }),
+  }
+
+  return (
+    <div className={`container ${styles.page}`}>
+      {firstImage !== null && (
+        <link rel="preload" as="image" href={firstImage} fetchPriority="high" />
+      )}
+      <Breadcrumb
+        items={crumbs}
+        serverHtml={renderNymbal('nymbal-breadcrumb', { items: JSON.stringify(crumbs) }).__html}
+      />
+      <h1 className={styles.pageTitle}>{category.name}</h1>
+      {category.description && <p className="text-muted mb-lg">{category.description}</p>}
+      <ListingControls
+        sort={sort}
+        category={slug}
+        facets={facets ?? []}
+        sortKeys={capabilities?.catalog.sortKeys ?? []}
+        defaultSort={capabilities?.catalog.defaultSort}
+      >
+        <ProductGrid
+          products={cards}
+          source="product-list"
+          hasMore={nextCursor !== null}
+          serverHtml={renderNymbal('nymbal-product-grid', grid).__html}
+        />
+      </ListingControls>
+    </div>
+  )
+}

package/scaffold/templates/nextjs/app/(catalog)/home/[key]/page.tsx

@@ -0,0 +1,80 @@
+import Link from 'next/link'
+import { notFound } from 'next/navigation'
+import { preload } from 'react-dom'
+import { fetchProducts, fetchCategories } from '@/lib/api'
+import { cardImageOf, cardProductOf, renderNymbal } from '@/lib/render'
+import { organizationJsonLd } from '@/lib/seo'
+import { HeroSection } from '@/components/server/HeroSection'
+import { CategoryNav, ProductGrid } from '@/components/client/elements'
+import { NewsletterSignup } from '@/components/client/NewsletterSignup'
+import styles from '@/styles/pages/home.module.css'
+
+// `/` is rewritten here (next.config.mjs): a dynamic segment with no params prerenders nothing at build, when the API
+// may be down, and Next caches its first render and regenerates it in the background every 300 s.
+export const revalidate = 300
+
+export function generateStaticParams(): Array<{ key: string }> {
+  return []
+}
+
+interface HomePageProps {
+  params: Promise<{ key: string }>
+}
+
+export default async function HomePage({ params }: HomePageProps) {
+  if ((await params).key !== 'index') notFound()
+  const [{ items }, categories] = await Promise.all([
+    fetchProducts({ limit: 8 }),
+    fetchCategories(),
+  ])
+  const products = items.map(cardProductOf)
+  // The first card's image is the page's likely LCP, and the preload scanner never reaches it inside the grid's shadow
+  // root: a preload in the head starts it. React's preload(), not a <link> element: a cached render writes an element
+  // and its preload both.
+  if (products[0] !== undefined) {
+    preload(cardImageOf(products[0]).url, { as: 'image', fetchPriority: 'high' })
+  }
+
+  const jsonLd = organizationJsonLd(
+    'Nymbal Store',
+    process.env.NEXT_PUBLIC_SITE_URL ?? 'http://localhost:3000',
+  )
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+
+      <HeroSection />
+
+      <section className={`container ${styles.categoriesSection}`}>
+        <h2 className="section-title">Shop by Category</h2>
+        <CategoryNav
+          categories={categories}
+          serverHtml={
+            renderNymbal('nymbal-category-nav', { categories: JSON.stringify(categories) }).__html
+          }
+        />
+      </section>
+
+      <section className={`container ${styles.featuredSection}`}>
+        <div className={styles.featuredHeader}>
+          <h2 className={styles.featuredTitle}>Featured Products</h2>
+          <Link href="/products" className={styles.featuredViewAll}>
+            View All
+          </Link>
+        </div>
+        <ProductGrid
+          products={products}
+          serverHtml={
+            renderNymbal('nymbal-product-grid', { products: JSON.stringify(products) }).__html
+          }
+        />
+      </section>
+
+      <NewsletterSignup />
+    </>
+  )
+}

package/scaffold/templates/nextjs/app/(catalog)/layout.tsx

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react'
+import { Header } from '@/components/server/Header'
+
+// The catalog's pages are the same for every shopper, so Next may cache them: the header reads no request, and the
+// mini-cart fills its count in the browser.
+export default function CatalogLayout({ children }: { children: ReactNode }) {
+  return (
+    <>
+      <Header />
+      <main id="main">{children}</main>
+    </>
+  )
+}

package/scaffold/templates/nextjs/app/(catalog)/not-found.tsx

@@ -0,0 +1,7 @@
+import { NotFoundView } from '@/components/server/NotFoundView'
+
+// A catalog page with nothing to show (a product no longer sold), under the catalog's header. Next caches it with the
+// page, so it reads no request.
+export default function CatalogNotFound() {
+  return <NotFoundView />
+}