ZSB — Zilele Sculpturii București

Website for Bucharest Sculpture Days, an annual contemporary sculpture event in Bucharest. Built with Next.js 16 (App Router), React 19, TypeScript, and Sanity as the CMS.

Setup

Requires Node.js 24.x (see .nvmrc; matches Vercel's Project Settings default) and pnpm.

pnpm install
pnpm dev          # Development server on localhost:3000

Scripts

Command	Description
pnpm dev	Start development server
pnpm build	Production build (also serves as the type-check)
pnpm start	Serve production build
pnpm typecheck	tsc --noEmit
pnpm lint / pnpm lint:fix	ESLint (./src)
pnpm format / pnpm format:check	Biome format (formatting only; linter disabled)
pnpm test	Vitest unit and component tests
pnpm test:e2e	Playwright journeys against a built app
pnpm images:unused	Find unused images in public/img/ (add :json for JSON output)

Project Structure

src/
  app/
    (site)/             # Route group — every public page
      page.tsx          # Homepage
      editions/         # Editions index + [year]/ dynamic pages
      artists/          # All-artists page
      about/ visit/ partners/ press/ privacy/
      layout.tsx        # Site chrome (Footer, CookieBanner, JsonLd, SanityLive)
    studio/[[...tool]]/ # Embedded Sanity Studio at /studio
    api/                # draft-mode enable/disable, revalidate/tag (Sanity webhook)
    layout.tsx          # Bare HTML shell + fonts + root metadata
    globals.css         # Cascade-layer order + element reset
    sitemap.ts, robots.ts
  components/           # Product components and site-shaped UI primitives
  design-system/        # Internal Panda preset (tokens, patterns, shared recipes)
  sanity/               # Studio config, schemaTypes, structure, GROQ queries, fetchers
  data/editions/        # index.ts gateway (every edition lives in Sanity)
  lib/                  # constants, seo, hooks, date/format utils
  types/                # Shared TypeScript types (Edition, ImageData)
scripts/                # Image + Sanity migration/seed utilities
docs/                   # Architecture (cms.md), ADRs (+ retired/), specs, plans/completed/

Key Concepts

• Editions — Sanity is the source of truth; every year is an edition document rendered via the dynamic route editions/[year]/, with no static edition files left (2021, the online-only year, was migrated into Sanity in ZSB-20). See docs/cms.md.
• CMS — Sanity Studio is embedded at /studio in this same app. Schema, GROQ, and the components that read them change in one PR. Run pnpm typegen after schema/query changes and commit sanity.types.ts.
• Image system — images authored in Sanity are served from Sanity's asset CDN via urlFor() (src/sanity/lib/image.ts), the single path for all content (editions, homepage, static pages). A missing CMS image falls back to a neutral local placeholder (src/lib/placeholder.ts → public/img/placeholder.jpg); singleton image fields are required(), so on a seeded dataset the placeholder never shows. ImageData is { src, alt }.
• Design system — Panda CSS owns styling and Ark UI privately supplies interaction behavior inside site-shaped primitives such as Accordion, Dialog, and Carousel. Pages and product components never assemble Ark parts. The internal preset at src/design-system/preset.ts owns tokens, shared patterns, and reusable recipes; panda.config.ts retains app extraction/build configuration. Product styling stays co-located in Component.recipe.ts files. Prefer semantic role tokens (canvas, heading, body, action, …) over raw gray.*.
• Fonts — Dela Gothic One (display) and Montserrat (body), loaded via next/font/google.

Deployment & content updates

Hosted on Vercel at sculpturedays.com. Pages are served from Next 16's cache (cacheComponents), so a published Sanity edit reaches prod via a webhook (/api/revalidate/tag) that busts the relevant cache tags — not on a timer. If a publish doesn't show in prod, check the webhook delivery log in sanity.io/manage. Environment variables (Sanity project/dataset/tokens, SANITY_REVALIDATE_SECRET) are documented in docs/cms.md.