README
nextkit
Configuration, libraries, and conventions for Next.js sites, as independently versioned packages. Built and maintained by Ingram Technologies.
Prime directive: a nextkit site is indistinguishable from a normal Next.js site, beyond its dependencies. nextkit does not wrap or replace Next.js.
Why
nextkit was extracted from several Next.js sites that kept re-implementing the same concerns: email, newsletters, bot protection, linting, testing, code style. Each concern is now one package with its own version, so a site adopts only what it needs and upgrades each piece on its own schedule.
Reasoning in full: docs/philosophy.md.
Packages
Published as @ingram-tech/<name>.
| Package | What |
|---|---|
nk-dev | The dev toolchain in one package: the nk CLI (nk dev/check/…, never required), shared oxlint + oxfmt / TypeScript / Vitest config, the format-on-commit hook, the AI agent guide, and nk init to scaffold a site |
nk-email | Zero-dep Cloudflare email client |
nk-forms | Public contact/signup submission pipeline: bot protection (honeypot + signed timing token + Vercel BotID), handleFormSubmission, escaped notification emails, and a headless client hook |
nk-db | Postgres data layer: shared pg pool, raw-SQL helpers, Drizzle wiring, PGlite (no-Docker) dev/test harness |
nk-auth | Better Auth foundation: composable presets a site spreads into its own betterAuth() |
nk-billing | Stripe helpers (client, customers, prices, currency, checkout, subscriptions, webhooks) + Stripe-side wallet + injection-based Postgres credit ledger |
nk-api | Typed API toolkit: Hono + zod-openapi router, auth/scope guards, cursor pagination, and a typed client, mounted into a Next.js route |
nk-i18n | i18n: intl-messageformat formatting, Accept-Language negotiation, and React client helpers |
nk-marketing | Postgres-backed marketing & lifecycle email: contacts + consent, newsletter audiences (broadcast), and idempotent triggered campaigns, with RFC 8058 one-click unsubscribe |
nk-seo | SEO toolkit: metadata factory, JSON-LD builders, sitemap/robots routes, hreflang + canonical links, OG image template |
nk-blog | File-indexed blog engine: frontmatter contract, limited-MDX rendering with a fixed set of allowed components, RSS, blog SEO, GitHub publishing |
nk-themes | Color-mode theming: cookie-backed <ThemeProvider> that paints without a flash on SSR, useTheme, and a headless <ThemeToggle> |
See docs/.
What the packages bind to
Only nk-seo, nk-blog, nk-themes, nk-i18n and nk-auth peer-depend on
Next.js; nk-forms needs React for its client hook, and nothing else. nk-email,
nk-db, nk-api, nk-billing and nk-marketing declare no framework peer at
all and work outside Next.js. Each package commits to at most one external
service, so adopting one does not commit you to the others:
nk-emailsends through Cloudflare Email Sending.nk-billingis Stripe.nk-dbis any Postgres reachable byDATABASE_URLoverpg(with Drizzle wiring and PGlite for local dev/test), not a hosted REST layer.nk-authis Better Auth.nk-forms' third bot-protection layer is Vercel BotID, and degrades to a no-op off Vercel; the honeypot and timing layers run anywhere.nk-devships oxlint, oxfmt, TypeScript and Vitest config.
The vendor reasoning behind those picks is in docs/philosophy.md.
Develop
bun install
bun run ci # check + build + type-check + test
bun run build # build all publishable packages
This repo uses its own configs. See docs/architecture.md.
Adopt it in a site
License
MIT © Ingram Technologies
Contributors
See what people are saying
Similar repos
Languages
TypeScript
77.6%
JavaScript
22.4%
README
nextkit
Configuration, libraries, and conventions for Next.js sites, as independently versioned packages. Built and maintained by Ingram Technologies.
Prime directive: a nextkit site is indistinguishable from a normal Next.js site, beyond its dependencies. nextkit does not wrap or replace Next.js.
Why
nextkit was extracted from several Next.js sites that kept re-implementing the same concerns: email, newsletters, bot protection, linting, testing, code style. Each concern is now one package with its own version, so a site adopts only what it needs and upgrades each piece on its own schedule.
Reasoning in full: docs/philosophy.md.
Packages
Published as @ingram-tech/<name>.
| Package | What |
|---|---|
nk-dev | The dev toolchain in one package: the nk CLI (nk dev/check/…, never required), shared oxlint + oxfmt / TypeScript / Vitest config, the format-on-commit hook, the AI agent guide, and nk init to scaffold a site |
nk-email | Zero-dep Cloudflare email client |
nk-forms | Public contact/signup submission pipeline: bot protection (honeypot + signed timing token + Vercel BotID), handleFormSubmission, escaped notification emails, and a headless client hook |
nk-db | Postgres data layer: shared pg pool, raw-SQL helpers, Drizzle wiring, PGlite (no-Docker) dev/test harness |
nk-auth | Better Auth foundation: composable presets a site spreads into its own betterAuth() |
nk-billing | Stripe helpers (client, customers, prices, currency, checkout, subscriptions, webhooks) + Stripe-side wallet + injection-based Postgres credit ledger |
nk-api | Typed API toolkit: Hono + zod-openapi router, auth/scope guards, cursor pagination, and a typed client, mounted into a Next.js route |
nk-i18n | i18n: intl-messageformat formatting, Accept-Language negotiation, and React client helpers |
nk-marketing | Postgres-backed marketing & lifecycle email: contacts + consent, newsletter audiences (broadcast), and idempotent triggered campaigns, with RFC 8058 one-click unsubscribe |
nk-seo | SEO toolkit: metadata factory, JSON-LD builders, sitemap/robots routes, hreflang + canonical links, OG image template |
nk-blog | File-indexed blog engine: frontmatter contract, limited-MDX rendering with a fixed set of allowed components, RSS, blog SEO, GitHub publishing |
nk-themes | Color-mode theming: cookie-backed <ThemeProvider> that paints without a flash on SSR, useTheme, and a headless <ThemeToggle> |
See docs/.
What the packages bind to
Only nk-seo, nk-blog, nk-themes, nk-i18n and nk-auth peer-depend on
Next.js; nk-forms needs React for its client hook, and nothing else. nk-email,
nk-db, nk-api, nk-billing and nk-marketing declare no framework peer at
all and work outside Next.js. Each package commits to at most one external
service, so adopting one does not commit you to the others:
nk-emailsends through Cloudflare Email Sending.nk-billingis Stripe.nk-dbis any Postgres reachable byDATABASE_URLoverpg(with Drizzle wiring and PGlite for local dev/test), not a hosted REST layer.nk-authis Better Auth.nk-forms' third bot-protection layer is Vercel BotID, and degrades to a no-op off Vercel; the honeypot and timing layers run anywhere.nk-devships oxlint, oxfmt, TypeScript and Vitest config.
The vendor reasoning behind those picks is in docs/philosophy.md.
Develop
bun install
bun run ci # check + build + type-check + test
bun run build # build all publishable packages
This repo uses its own configs. See docs/architecture.md.
Adopt it in a site
License
MIT © Ingram Technologies
See what people are saying
Similar repos
Contributors
Languages
TypeScript
77.6%
JavaScript
22.4%