Skip to content

next-site features

Generated from templates/next-site/template.json.

FeatureDefaultWhat it adds
cms
Payload CMS
Always

Pages built from blocks (content, media, call to action, banner, code, form), media uploads, header and footer menus, contact forms with emailed submissions, SEO fields, and the admin at /admin. Postgres through Payload's own adapter, which owns the schema and migrations.

ui
UI kit (src/components/ui)
Always

The house UI kit (button, card, checkbox, input, label, select, toasts, textarea), its light/dark theme with a no-flash init script, and its tokens, shared with react-app and react-monorepo (see derive-ui.sh), plus the storefront's own dialog, sheet and carousel on the same tokens.

shop
Shop
Opt-in

Payload's ecommerce plugin: products with variants and stock, cart, checkout, customer accounts and addresses, guest checkout and order lookup. Prices are in one currency (GHS by default, src/lib/currency.ts). Payment is pluggable (src/payments); the bundled manual method creates the order as awaiting payment, shows the owner's payment instructions, emails both sides, and the owner marks it paid in the admin.

Packages: @payloadcms/plugin-ecommerce, embla-carousel-auto-scroll, embla-carousel-react

Files it owns (52)
  • src/collections/Products/**
  • src/collections/Orders/**
  • src/collections/Categories.ts
  • src/globals/ShopSettings.ts
  • src/payments/**
  • src/lib/currency.ts
  • src/lib/constants.ts
  • src/app/(app)/(account)/**
  • src/app/(app)/checkout/**
  • src/app/(app)/create-account/**
  • src/app/(app)/find-order/**
  • src/app/(app)/forgot-password/**
  • src/app/(app)/login/**
  • src/app/(app)/logout/**
  • src/app/(app)/products/**
  • src/app/(app)/shop/**
  • src/components/AccountNav/**
  • src/components/addresses/**
  • src/components/Cart/**
  • src/components/CollectionArchive/**
  • src/components/CategoryTabs/**
  • src/components/checkout/**
  • src/components/forms/AccountForm/**
  • src/components/forms/AddressForm/**
  • src/components/forms/CreateAccountForm/**
  • src/components/forms/FindOrderForm/**
  • src/components/forms/ForgotPasswordForm/**
  • src/components/forms/LoginForm/**
  • src/components/Grid/**
  • src/components/Header/MobileAccountMenu.tsx
  • src/components/Header/ShopActions.tsx
  • src/components/layout/search/**
  • src/components/OrderItem/**
  • src/components/OrderStatus/**
  • src/components/Price.tsx
  • src/components/product/**
  • src/components/ProductGridItem/**
  • src/components/ProductItem/**
  • src/components/Search/**
  • src/components/ui/carousel.tsx
  • src/blocks/ArchiveBlock/**
  • src/blocks/Carousel/**
  • src/blocks/ThreeItemGrid/**
  • src/access/adminOrCustomerOwner.ts
  • src/access/customerOnlyFieldAccess.ts
  • src/access/isDocumentOwner.ts
  • src/providers/Auth/**
  • src/providers/Shop.tsx
  • src/endpoints/seed/shop/**
  • tests/e2e/frontend.e2e.spec.ts
  • tests/int/manual-payment.int.spec.ts
  • .claude/skills/add-payment-provider/**
redirects
Owner-managed redirects
On

Content → Redirects in the admin, for pages that moved or were renamed. Checked only when a page is not found, so they cost nothing on pages that exist.

Packages: @payloadcms/plugin-redirects

Files it owns (1)
  • src/redirects/**
telemetry
Monitoring → OpenObserve
On

OpenTelemetry on the server (Next's request and render spans, outgoing HTTP, Postgres, logs, metrics) and OpenObserve RUM in the browser (page views, errors, slow resources, the signed-in customer's id), with trace headers so a click links to the server trace. Off at runtime until OPENOBSERVE_* / NEXT_PUBLIC_OPENOBSERVE_* are set.

Packages: @openobserve/browser-logs, @openobserve/browser-rum, @opentelemetry/auto-instrumentations-node, @opentelemetry/exporter-logs-otlp-proto, @opentelemetry/exporter-metrics-otlp-proto, @opentelemetry/exporter-trace-otlp-proto, @opentelemetry/resources, @opentelemetry/sdk-logs, @opentelemetry/sdk-metrics, @opentelemetry/sdk-node, @opentelemetry/semantic-conventions

Files it owns (2)
  • src/telemetry/**
  • src/instrumentation.ts
testing
Tests (Vitest + Playwright)
On

Integration tests against a real Payload and Postgres (tests/int), and Playwright end-to-end tests of the admin and, with the shop, the storefront (tests/e2e).

Packages: @playwright/test, @vitejs/plugin-react, dotenv, jsdom, tsx, vite-tsconfig-paths, vitest

Files it owns (5)
  • tests/**
  • vitest.config.mts
  • vitest.setup.ts
  • playwright.config.ts
  • test.env
husky
Git hooks + lint-staged
On

Packages: husky, lint-staged

Files it owns (1)
  • .husky/**
docker
Docker image
On

Multi-stage build of Next's standalone server, Payload included. Builds without a database; pending migrations run when the server starts; uploads go to a volume at /app/media; /api/health for the healthcheck.

Files it owns (3)
  • Dockerfile
  • .dockerignore
  • build.sh
ci
Forgejo Actions CI
On

Format, lint, typecheck and build on every branch; build and push the image from main.

Files it owns (1)
  • .forgejo/**
secrets
Infisical secret sync
On

Packages: @aurostack/secrets

Files it owns (1)
  • infisical.jsonc
  • shop is off by default. stack add shop adds it to a site generated without it.
  • search indexes pages (and products) as they are saved; content that existed before the feature was added is indexed the next time it is saved.
  • redirects are checked only when a page is not found.