next-site features
Generated from templates/next-site/template.json.
| Feature | Default | What it adds |
|---|---|---|
cmsPayload 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. |
uiUI 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. |
shopShop | 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 Files it owns (52)
|
searchSite search | On | Payload's search plugin keeps an index of pages (and products, with the shop) in step as they are edited; /search queries it. Files it owns (2)
|
redirectsOwner-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. Files it owns (1)
|
telemetryMonitoring → 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. Files it owns (2)
|
testingTests (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). Files it owns (5)
|
huskyGit hooks + lint-staged | On | Files it owns (1)
|
dockerDocker 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)
|
ciForgejo Actions CI | On | Format, lint, typecheck and build on every branch; build and push the image from main. Files it owns (1)
|
secretsInfisical secret sync | On | Files it owns (1)
|
shopis off by default.stack add shopadds it to a site generated without it.searchindexes pages (and products) as they are saved; content that existed before the feature was added is indexed the next time it is saved.redirectsare checked only when a page is not found.