@btst/stack 3.0.0 → 3.0.1

package/README.md

@@ -1,289 +1,181 @@
-# @btst/stack — BTST
+# BTST
 
 <div align="center">
 
-**Installable full-stack features for React apps**  
-Framework-agnostic. Database-flexible. No lock-in.
+## Add complete features to the React app you already own.
 
-[![npm](https://img.shields.io/npm/v/@btst/stack.svg)](https://www.npmjs.com/package/@btst/stack)
-[![MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-[Docs](https://www.better-stack.ai/docs) · [Examples](./examples) · [Issues](https://github.com/better-stack-ai/better-stack/issues)
-
-</div>
+BTST is an open-source TypeScript system for installing full-stack features into existing React applications.
 
----
+It is built for React/TypeScript developers and small product teams adding a substantial feature to an app they already have. A full-stack plugin can bring the routes, APIs, database schema, hooks, SSR-aware pages, and customizable UI that its feature needs.
 
-## What is BTST?
+**You own the whole application.** Your app, data, deployment, and ejected UI stay yours. BTST runs inside your stack as an open-source dependency you can inspect, fork, or replace—never as a required hosted control plane.
 
-BTST lets you **install production-ready app features as npm packages**.
+[**Quickstart with Blog**](#quickstart-blog-in-an-existing-nextjs-app) · [View the live Blog](https://www.better-stack.ai/p/blog) · [Read the docs](https://www.better-stack.ai/docs)
 
-Instead of spending weeks building the same things again and again  
-(routes, APIs, database schemas, SSR, SEO, forms…):
+[![npm](https://img.shields.io/npm/v/@btst/stack.svg)](https://www.npmjs.com/package/@btst/stack)
+[![MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](./LICENSE.md)
 
-```bash
-npm install @btst/stack
-````
+![BTST promise above a focused view of the real Blog route from the generated application.](docs/assets/product-proof/readme-hero.webp)
 
-Enable the features you need and keep building your product.
+<sub>Real output from the repository's generated Next.js application.</sub>
 
-### Available plugins
+</div>
 
-| Plugin | Description |
-|--------|-------------|
-| **Blog** | Content management, editor, drafts, publishing, SEO, RSS feeds |
-| **AI Chat** | AI-powered chat with conversation history, streaming, and customizable models |
-| **CMS** | Headless CMS with custom content types, Zod schemas, and auto-generated forms |
-| **Form Builder** | Dynamic form builder with drag-and-drop editor, submissions, and validation |
-| **UI Builder** | Visual drag-and-drop page builder with component registry and public rendering |
-| **Kanban** | Project management with boards, columns, tasks, drag-and-drop, and priority levels |
-| **Media** | Media library with uploads, folders, picker UI, URL registration, and reusable image inputs |
-| **OpenAPI** | Auto-generated API documentation with interactive Scalar UI |
-| **Route Docs** | Auto-generated client route documentation with interactive navigation |
-| **Comments** | Commenting system with moderation, likes, and nested replies |
+## Where BTST fits
 
-Full-stack plugins ship separate frontend and backend definitions: routes,
-APIs, database models, React components, SSR, and SEO—already wired. Intentional
-one-sided plugins stay one-sided: OpenAPI is backend-only, Route Docs is
-client-only, and UI Builder is client-only over CMS.
+BTST is **more complete than a UI kit, more incremental than a starter application, and more ownable than a hosted feature service**.
 
-**Want a specific plugin?** [Open an issue](https://github.com/better-stack-ai/better-stack/issues/new) and let us know!
+| Starting point | What it gives you | Adoption boundary |
+| --- | --- | --- |
+| UI kit | Components and interaction primitives | Your team still builds the feature's routes, data model, APIs, and workflows |
+| Starter application | An application foundation with initial features | You adopt its application structure as the place you start |
+| Hosted feature service | A feature operated behind a vendor service boundary | Its control plane, runtime, or data path remains outside your application |
+| **BTST** | An installable feature runtime, generated integration, and customizable views | Add one capability inside the app, database, and deployment you already operate |
 
----
+Start with one plugin and add more only when they are useful. BTST does not replace your application foundation or require a hosted control plane.
 
-## Why use it?
+![Diagram separating the application and operating boundaries a team owns from the BTST runtimes and plugins running inside it.](docs/assets/product-proof/ownership-diagram.svg)
 
-* **Installable features** – real product features, not just UI
-* **Framework-agnostic** – Next.js, React Router, TanStack Router, Remix
-* **Database-flexible** – Prisma, Drizzle, Kysely, MongoDB
-* **Zero boilerplate** – no manual route or API wiring
-* **Type-safe** – end-to-end TypeScript
+<p align="center"><sub>BTST composes client and backend plugins inside the application; the app shell, ejected views, database, deployment, and external services remain yours.</sub></p>
 
-You keep your codebase, database, and deployment.
+## Quickstart: Blog in an existing Next.js app
 
----
+This local evaluation uses the public stable releases with Node.js 22, an existing Next.js 15+ App Router application, and Radix-based shadcn/ui with CSS variables. If shadcn/ui is not configured yet, initialize that verified base and add the components Blog needs:
 
-## Minimal setup (Next.js)
+```bash
+pnpm dlx shadcn@4.19.1 init --base radix --preset nova --css-variables
+pnpm dlx shadcn@4.19.1 add button dropdown-menu sonner --yes
+```
 
-```ts title="lib/stack.ts"
-import { createBackendStack } from "@btst/stack/api"
-import { blogBackendPlugin } from "@btst/stack/plugins/blog/api"
-import { createMemoryAdapter } from "@btst/adapter-memory"
+Render the generated `<Toaster />` in your root layout and start from a clean commit you can review. The [complete prerequisite checklist](https://www.better-stack.ai/docs/installation#quickstart-prerequisites) covers the remaining application requirements.
 
-function createAppStack() {
-  return createBackendStack({
-    basePath: "/api/data",
-    plugins: {
-      blog: blogBackendPlugin()
-    },
-    adapter: (db) => createMemoryAdapter(db)({})
-  })
-}
+Run the released generator from the application root:
 
-type AppStack = ReturnType<typeof createAppStack>
-const globalForStack = globalThis as typeof globalThis & {
-  __btst_stack__?: AppStack
-}
-export const myStack = globalForStack.__btst_stack__ ??= createAppStack()
-export const { handler, dbSchema } = myStack
+```bash
+pnpm dlx @btst/codegen@0.2.0 init \
+  --framework nextjs \
+  --adapter memory \
+  --plugins blog
 ```
 
-```tsx title="lib/stack-client.tsx"
-import {
-  createClientStack,
-  type ClientPluginEndpointOverride,
-} from "@btst/stack/client"
-import { blogClientPlugin } from "@btst/stack/plugins/blog/client"
-import type { QueryClient } from "@tanstack/react-query"
+The generator shows detected-file and conflict prompts before it writes. It installs `@btst/stack@3.0.0`, registers Blog on the backend and client, mounts the API and page routes, adds the plugin CSS, and wires the shared provider.
 
-export interface StackClientOptions {
-  apiOrigin: string
-  siteOrigin: string
-}
+Set the trusted local origins in `.env.local`:
 
-export function createAppClientStack(
-  queryClient: QueryClient,
-  options: StackClientOptions & { headers?: HeadersInit },
-) {
-  const { apiOrigin, siteOrigin } = options
-  const crossOriginBlogEndpoint = apiOrigin === siteOrigin
-    ? undefined
-    : {
-        api: {
-          baseURL: apiOrigin,
-          basePath: "/api/data",
-          credentials: "include",
-        },
-      } satisfies ClientPluginEndpointOverride
+```dotenv
+BTST_SITE_URL=http://localhost:3000
+BTST_API_URL=http://localhost:3000
+```
 
-  return createClientStack({
-    api: {
-      baseURL: apiOrigin,
-      basePath: "/api/data",
-      ...(options.headers ? { headers: options.headers } : {}),
-    },
-    site: { baseURL: siteOrigin, basePath: "/pages" },
-    queryClient,
-    plugins: {
-      blog: blogClientPlugin()
-    },
-    ...(crossOriginBlogEndpoint
-      ? { endpoints: { blog: crossOriginBlogEndpoint } }
-      : {}),
-  })
-}
+Then start the app and open the generated route:
 
-export function getStackClient(
-  queryClient: QueryClient,
-  options: StackClientOptions,
-) {
-  return createAppClientStack(queryClient, options)
-}
+```bash
+pnpm dev
+# http://localhost:3000/pages/blog
 ```
 
-The generated `lib/stack-client.server.ts` resolves these origins from trusted
-deployment configuration (`BTST_API_URL` and `BTST_SITE_URL`), defaults the API
-to the trusted site origin, and forwards filtered credentials only to that API.
-It fails closed in production if no trusted origin is available.
-Existing same-origin Next.js installs may keep `NEXT_PUBLIC_BASE_URL` while
-migrating; new deployments should prefer the separate site/API variables.
+`/pages/blog` is the success condition. A fresh local route can be empty until you create content. The memory adapter resets with the process and is for evaluation and tests, not production persistence; Blog image uploads also remain an explicit application override. Continue with the [production and manual setup reference](https://www.better-stack.ai/docs/installation) before deploying.
 
-Use the v3 framework entry factories for the two catch-all routes:
+![Real BTST Blog page with three published product-update posts in the generated Next.js application.](docs/assets/product-proof/blog-proof.webp)
 
-```ts title="app/api/data/[[...all]]/route.ts"
-import { toNextRouteHandlers } from "@btst/stack/next"
-import { handler } from "@/lib/stack"
+<p align="center"><sub>The same generated Blog route after deterministic sample content is added.</sub></p>
 
-export const { GET, POST, PUT, PATCH, DELETE } =
-  toNextRouteHandlers(handler)
-```
+### The registration that produces the route
 
-```tsx title="app/(request)/pages/[[...all]]/page.tsx"
-import { createNextPage } from "@btst/stack/next"
-import { headers } from "next/headers"
-import { getStackClientForRequest } from "@/lib/stack-client.server"
-import { getOrCreateQueryClient } from "@/lib/query-client"
+The stable-v3 seam is deliberately small: the backend plugin supplies Blog's server behavior and data model; the client plugin supplies its routes and UI. The generator provides the surrounding adapter, API/site runtime, QueryClient, catch-all routes, and provider wiring.
 
-export const dynamic = "force-dynamic"
+```ts
+import { createBackendStack } from "@btst/stack/api"
+import { createMemoryAdapter } from "@btst/adapter-memory"
+import { blogBackendPlugin } from "@btst/stack/plugins/blog/api"
 
-const page = createNextPage({
-  getStackClient: async (queryClient) =>
-    getStackClientForRequest(queryClient, {
-      headers: new Headers(await headers()),
-    }),
-  getQueryClient: getOrCreateQueryClient,
+createBackendStack({
+  basePath: "/api/data",
+  adapter: (db) => createMemoryAdapter(db)({}),
+  plugins: { blog: blogBackendPlugin() },
 })
-export default page.Page
-export const generateMetadata = page.generateMetadata
 ```
 
-The request layout at `app/(request)/pages/layout.tsx` hydrates trusted client
-origins into the shared provider in `app/pages/client-layout.tsx`. Put SSG/ISR
-routes under `app/(static)/pages` with a header-free layout; route groups do not
-change the public `/pages/*` URLs.
-
-Wrap the pages subtree with one `StackProvider`:
-
 ```tsx
-// app/pages/client-layout.tsx
-"use client"
-
-function PagesClientLayout({ children, clientOrigins }: {
-  children: React.ReactNode
-  clientOrigins: StackClientOptions
-}) {
-  const queryClient = getOrCreateQueryClient()
-  const clientStack = useMemo(
-    () => getStackClient(queryClient, clientOrigins),
-    [clientOrigins.apiOrigin, clientOrigins.siteOrigin, queryClient],
-  )
-
-  return (
-    <QueryClientProvider client={queryClient}>
-      <StackProvider
-        stack={clientStack}
-        router={nextRouter()}
-        auth={authProvider}
-        overrides={{ blog: { uploadImage } }}
-      >
-        {children}
-      </StackProvider>
-    </QueryClientProvider>
-  )
-}
-```
-
-API, site, and QueryClient runtime belong on the resolved client stack; router
-and auth services belong on the provider. Plugin overrides contain only
-plugin-specific customization. See the [full installation guide](https://www.better-stack.ai/docs/installation)
-for QueryClient wiring, database adapters, all three frameworks, and auth.
-
-## Database schemas & migrations
-
-Generate schemas and run migrations through the v3 codegen CLI. It runs the
-aligned Better DB CLI in isolation, so its dependencies and `btst` binary do
-not enter your application graph:
+import { createClientStack } from "@btst/stack/client"
+import { blogClientPlugin } from "@btst/stack/plugins/blog/client"
+import type { QueryClient } from "@tanstack/react-query"
 
-```bash
-npx @btst/codegen@0.2.0 generate --orm drizzle --config lib/stack.ts --output db/schema.ts
+function createAppClientStack(queryClient: QueryClient, origin: string) {
+  return createClientStack({
+    api: { baseURL: origin, basePath: "/api/data" },
+    site: { baseURL: origin, basePath: "/pages" },
+    queryClient,
+    plugins: { blog: blogClientPlugin() },
+  })
+}
 ```
 
-Supports Prisma, Drizzle, MongoDB and Kysely SQL dialects.
+![The current Blog backend and client registrations point to the real published Blog route they produce.](docs/assets/product-proof/code-to-result.webp)
 
----
+Blog adds publishing routes, API operations, its data model, hooks, SSR-aware pages, editor UI, published-page metadata, and sitemap entries. Other plugins have different boundaries: one-sided and companion plugins are labeled instead of being forced into a full-stack claim.
 
-## Shadcn Registry
+## Released capabilities
 
-Each plugin's UI layer is available as a [shadcn registry](https://ui.shadcn.com/docs/registry) block. Use it to **eject and fully customize** the page components while keeping all data-fetching and API logic from `@btst/stack`:
+Every capability below is installable from the released CLI. Follow its documentation for the actual payload, services, storage, auth, and adapter prerequisites.
 
-```bash
-# Install a single plugin's UI (for example, Media)
-npx shadcn@latest add https://github.com/better-stack-ai/better-stack/blob/main/packages/stack/registry/btst-media.json
+| Capability | Topology | Outcome |
+| --- | --- | --- |
+| [Blog](https://www.better-stack.ai/docs/plugins/blog) | Full-stack | Publishing workflow, routes, API, data model, editor, metadata, and sitemap entries |
+| [AI Chat](https://www.better-stack.ai/docs/plugins/ai-chat) | Full-stack | Streaming conversations, model integration, history, routes, and chat UI |
+| [CMS](https://www.better-stack.ai/docs/plugins/cms) | Full-stack | Typed content models, APIs, generated forms, and editorial UI |
+| [Form Builder](https://www.better-stack.ai/docs/plugins/form-builder) | Full-stack | Form authoring, validation, rendering, and submissions |
+| [Kanban](https://www.better-stack.ai/docs/plugins/kanban) | Full-stack | Boards, columns, tasks, assignment, and drag-and-drop UI |
+| [Comments](https://www.better-stack.ai/docs/plugins/comments) | Full-stack | Threads, replies, reactions, moderation, and embeddable UI |
+| [Media](https://www.better-stack.ai/docs/plugins/media) | Full-stack | Media storage, library routes, uploads, folders, and picker UI |
+| [UI Builder](https://www.better-stack.ai/docs/plugins/ui-builder) | Client-only · requires CMS | Visual page authoring and public rendering over CMS content |
+| [OpenAPI](https://www.better-stack.ai/docs/plugins/open-api) | Backend-only | Generated OpenAPI document and interactive API reference endpoint |
+| [Route Docs](https://www.better-stack.ai/docs/plugins/route-docs) | Client-only | Generated route reference and navigation UI |
+| [Better Auth UI](https://www.better-stack.ai/docs/plugins/better-auth-ui) | Companion · requires Better Auth | Auth and account pages for an existing Better Auth backend |
 
-# Or install the full collection
-npx shadcn@latest add https://github.com/better-stack-ai/better-stack/blob/main/packages/stack/registry/registry.json
-```
+[Explore the released catalog](https://www.better-stack.ai/docs/plugins) or compare complete generated setups in the [interactive playground](https://www.better-stack.ai/playground?plugins=blog,ai-chat,comments&framework=nextjs&view=preview).
 
-Components are copied into `src/components/btst/{plugin}/client/` — all relative imports remain valid and you can edit them freely.
+## Compatibility and prerequisites
 
----
+The maintained and tested v3 integration paths are:
 
-## AI Agent Skills
+| Framework | Maintained integration |
+| --- | --- |
+| Next.js 15+ App Router | Route handlers, request-aware and static pages, metadata, and sitemap factories |
+| React Router v7 | Framework routes, SSR loaders, navigation, metadata, and sitemap response helpers |
+| TanStack Start | File routes, SSR loaders, navigation, metadata, and sitemap response helpers |
 
-If you're using an AI coding agent (Cursor, Claude Code, VS Code, OpenAI Codex etc.) you can install the BTST integration skill so your agent understands the plugin system, adapter setup, and wiring patterns out of the box:
+Other React integrations may be possible through custom adapters, but they are not part of that maintained matrix.
 
-```bash
-npx skills@latest add better-stack-ai/better-stack/.agents/skills/btst-integration
-```
-
-Or manually copy [`skills/btst-integration/SKILL.md`](./.agents/skills/btst-integration/SKILL.md) into your project's agent skills directory.
-
----
+Versioned adapters are published for Prisma, Drizzle, Kysely, and MongoDB. Support is not blanket-equivalent: plugins that need isolated transactions have stricter persistent-adapter requirements, and the generated Form Builder and Media configurations reject MongoDB. The memory adapter is local and single-process only. Check [compatibility and prerequisites](https://www.better-stack.ai/docs/installation#compatibility-and-prerequisites) and the [adapter guide](https://www.better-stack.ai/docs/databases/adapters) for current versions and limits.
 
-## Live Demo
+## Keep the view code, too
 
-Try the interactive playground:
+BTST's packaged runtime keeps data fetching and behavior upgradeable. When a plugin offers a shadcn v4 registry block, it copies the view layer into your application. Edit that code freely, then pass pages back through the plugin's component overrides where available or render copied components directly; hooks and API behavior can remain package dependencies.
 
-* [Next.js](https://www.better-stack.ai/playground?plugins=blog,ai-chat,comments&framework=nextjs&view=preview)
-* [React Router](https://www.better-stack.ai/playground?plugins=blog,ai-chat,comments&framework=react-router&view=preview)
-* [TanStack Router](https://www.better-stack.ai/playground?plugins=blog,ai-chat,comments&framework=tanstack&view=preview)
+[Read the ejection guide](https://www.better-stack.ai/docs/shadcn-registry)
 
----
+## Go deeper
 
-## Learn more
+- [Installation and production setup](https://www.better-stack.ai/docs/installation) — frameworks, providers, auth, origins, adapters, and migrations
+- [How BTST works](https://www.better-stack.ai/docs/how-it-works) — backend/client composition and ownership boundaries
+- [CLI reference](https://www.better-stack.ai/docs/cli) — initialize, generate schemas, migrate, and seed
+- [Build a plugin](https://www.better-stack.ai/docs/plugins/development) — create a backend-only, client-only, or full-stack capability
+- [API reference](https://www.better-stack.ai/docs/api-reference) — stack factories, runtime services, and framework adapters
+- [Stable-v3 migration guide](https://www.better-stack.ai/docs/breaking-changes) — migrate older integrations to the released contract
 
-Full documentation, guides, and plugin development:
-👉 **[https://www.better-stack.ai](https://www.better-stack.ai)**
+### Optional AI-agent guidance
 
----
+After you understand the human installation path, you can give a coding agent the repository's BTST integration skill:
 
-## Contributing
+```bash
+npx skills@latest add better-stack-ai/better-stack/.agents/skills/btst-integration
+```
 
-Bug reports, plugin PRs, and documentation improvements are welcome.
-See **[CONTRIBUTING.md](./CONTRIBUTING.md)** for the plugin development guide, testing instructions, and submission checklist.
+## Contributing and license
 
----
+Bug reports, plugin contributions, and documentation improvements are welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md) for the development workflow, tests, and submission checklist; public-facing copy follows the [BTST message and claims contract](./docs/positioning.md).
 
-If this saves you time, a ⭐ helps others find it.
+BTST is released under the [MIT License](./LICENSE.md).
 
-MIT © [olliethedev](https://github.com/olliethedev)
+If BTST is useful to you, a star helps other React developers find it.

package/dist/packages/stack/src/plugins/blog/client/components/pages/post-page.internal.cjs

@@ -3,7 +3,7 @@
 
 const jsxRuntime = require('react/jsx-runtime');
 const context = require('@btst/stack/context');
-const dateFns = require('date-fns');
+const formatPostDate = require('../shared/format-post-date.cjs');
 const blogHooks = require('../../hooks/blog-hooks.cjs');
 const emptyList = require('../shared/empty-list.cjs');
 const markdownContent = require('../shared/markdown-content.cjs');
@@ -122,7 +122,7 @@ ${post.content ?? ""}`.slice(
 }
 function PostHeaderTop({ post }) {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-row items-center justify-center gap-2 flex-wrap mt-8", children: [
-    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-light text-muted-foreground text-sm", children: dateFns.formatDate(post.createdAt, "MMMM d, yyyy") }),
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-light text-muted-foreground text-sm", children: formatPostDate.formatPostDate(post.createdAt) }),
     /* @__PURE__ */ jsxRuntime.jsx(collapsibleTagList.CollapsibleTagList, { tags: post.tags ?? [] })
   ] });
 }

package/dist/packages/stack/src/plugins/blog/client/components/pages/post-page.internal.mjs

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { useTranslate, usePluginOverrides, useStack } from '@btst/stack/context';
-import { formatDate } from 'date-fns';
+import { formatPostDate } from '../shared/format-post-date.mjs';
 import { useSuspensePost, useNextPreviousPosts, useRecentPosts } from '../../hooks/blog-hooks.mjs';
 import { EmptyList } from '../shared/empty-list.mjs';
 import { MarkdownContent } from '../shared/markdown-content.mjs';
@@ -120,7 +120,7 @@ ${post.content ?? ""}`.slice(
 }
 function PostHeaderTop({ post }) {
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-row items-center justify-center gap-2 flex-wrap mt-8", children: [
-    /* @__PURE__ */ jsx("span", { className: "font-light text-muted-foreground text-sm", children: formatDate(post.createdAt, "MMMM d, yyyy") }),
+    /* @__PURE__ */ jsx("span", { className: "font-light text-muted-foreground text-sm", children: formatPostDate(post.createdAt) }),
     /* @__PURE__ */ jsx(CollapsibleTagList, { tags: post.tags ?? [] })
   ] });
 }

package/dist/packages/stack/src/plugins/blog/client/components/shared/format-post-date.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const formatter = new Intl.DateTimeFormat("en-US", {
+  month: "long",
+  day: "numeric",
+  year: "numeric",
+  timeZone: "UTC"
+});
+function formatPostDate(date) {
+  return formatter.format(new Date(date));
+}
+
+exports.formatPostDate = formatPostDate;

package/dist/packages/stack/src/plugins/blog/client/components/shared/format-post-date.mjs

@@ -0,0 +1,11 @@
+const formatter = new Intl.DateTimeFormat("en-US", {
+  month: "long",
+  day: "numeric",
+  year: "numeric",
+  timeZone: "UTC"
+});
+function formatPostDate(date) {
+  return formatter.format(new Date(date));
+}
+
+export { formatPostDate };

package/dist/packages/stack/src/plugins/blog/client/components/shared/post-card.cjs

@@ -5,7 +5,7 @@ const jsxRuntime = require('react/jsx-runtime');
 const badge = require('../../../../../../../ui/src/components/badge.cjs');
 const card = require('../../../../../../../ui/src/components/card.cjs');
 const context = require('@btst/stack/context');
-const dateFns = require('date-fns');
+const formatPostDate = require('./format-post-date.cjs');
 const LucideIcons = require('lucide-react');
 const constants = require('../../constants.cjs');
 const defaults = require('./defaults.cjs');
@@ -214,10 +214,8 @@ function PostCard({ post }) {
   const Image = router?.Image ?? defaults.DefaultImage;
   const basePath = context.useBasePath();
   const blogPath = `${basePath}/blog/${post.slug}`;
-  const postDate = dateFns.formatDate(
-    post.publishedAt || post.createdAt,
-    "MMMM d, yyyy"
-  );
+  const timestamp = post.publishedAt || post.createdAt;
+  const postDate = formatPostDate.formatPostDate(timestamp);
   const gradient = post.image ? null : getGradientFromTitle(post.title);
   return /* @__PURE__ */ jsxRuntime.jsxs(card.Card, { className: "group relative flex h-full flex-col gap-4 pt-0! pb-4! transition-shadow duration-200 hover:shadow-lg", children: [
     /* @__PURE__ */ jsxRuntime.jsx(
@@ -264,7 +262,7 @@ function PostCard({ post }) {
           /* @__PURE__ */ jsxRuntime.jsx(card.CardContent, { className: "flex flex-1 flex-col gap-2", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap gap-2", children: [
             /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2 text-muted-foreground text-xs", children: [
               /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.CalendarIcon, { className: "h-3 w-3" }),
-              /* @__PURE__ */ jsxRuntime.jsx("time", { dateTime: postDate, children: postDate })
+              /* @__PURE__ */ jsxRuntime.jsx("time", { dateTime: timestamp, children: postDate })
             ] }),
             post.tags && post.tags.length > 0 && post.tags.map((tag) => /* @__PURE__ */ jsxRuntime.jsx(badge.Badge, { variant: "secondary", className: "text-xs", children: tag.name }, tag.id))
           ] }) })

package/dist/packages/stack/src/plugins/blog/client/components/shared/post-card.mjs

@@ -3,7 +3,7 @@ import { jsxs, jsx } from 'react/jsx-runtime';
 import { Badge } from '../../../../../../../ui/src/components/badge.mjs';
 import { Card, CardHeader, CardTitle, CardContent } from '../../../../../../../ui/src/components/card.mjs';
 import { useTranslate, usePluginOverrides, useStack, useBasePath } from '@btst/stack/context';
-import { formatDate } from 'date-fns';
+import { formatPostDate } from './format-post-date.mjs';
 import { CalendarIcon } from 'lucide-react';
 import { BLOG_PLUGIN_ID } from '../../constants.mjs';
 import { DefaultLink, DefaultImage } from './defaults.mjs';
@@ -212,10 +212,8 @@ function PostCard({ post }) {
   const Image = router?.Image ?? DefaultImage;
   const basePath = useBasePath();
   const blogPath = `${basePath}/blog/${post.slug}`;
-  const postDate = formatDate(
-    post.publishedAt || post.createdAt,
-    "MMMM d, yyyy"
-  );
+  const timestamp = post.publishedAt || post.createdAt;
+  const postDate = formatPostDate(timestamp);
   const gradient = post.image ? null : getGradientFromTitle(post.title);
   return /* @__PURE__ */ jsxs(Card, { className: "group relative flex h-full flex-col gap-4 pt-0! pb-4! transition-shadow duration-200 hover:shadow-lg", children: [
     /* @__PURE__ */ jsx(
@@ -262,7 +260,7 @@ function PostCard({ post }) {
           /* @__PURE__ */ jsx(CardContent, { className: "flex flex-1 flex-col gap-2", children: /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-2", children: [
             /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 text-muted-foreground text-xs", children: [
               /* @__PURE__ */ jsx(CalendarIcon, { className: "h-3 w-3" }),
-              /* @__PURE__ */ jsx("time", { dateTime: postDate, children: postDate })
+              /* @__PURE__ */ jsx("time", { dateTime: timestamp, children: postDate })
             ] }),
             post.tags && post.tags.length > 0 && post.tags.map((tag) => /* @__PURE__ */ jsx(Badge, { variant: "secondary", className: "text-xs", children: tag.name }, tag.id))
           ] }) })

package/dist/plugins/blog/api/index.d.cts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.DiYg7Jw1.cjs';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.CtrnoQgH.cjs';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.cjs';
 export { blogPermissions } from '../permissions.cjs';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.DtZgEX84.cjs';
+import '../../../shared/stack.CKc_Bais.cjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.cjs';
 import 'zod/v4/core';

package/dist/plugins/blog/api/index.d.mts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.CZ1h_T4k.mjs';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.BggTHKlo.mjs';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.mjs';
 export { blogPermissions } from '../permissions.mjs';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.DtZgEX84.mjs';
+import '../../../shared/stack.CKc_Bais.mjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.mjs';
 import 'zod/v4/core';

package/dist/plugins/blog/api/index.d.ts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.DQpyA3Cq.js';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.lPKwd_v0.js';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.js';
 export { blogPermissions } from '../permissions.js';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.DtZgEX84.js';
+import '../../../shared/stack.CKc_Bais.js';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.js';
 import 'zod/v4/core';

package/dist/plugins/blog/client/hooks/index.d.cts

@@ -1,9 +1,9 @@
-export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.rmWRtSjs.cjs';
+export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.BTStHVTy.cjs';
 export { useDebounce } from '@btst/stack/plugins/client/hooks';
 import '@tanstack/react-query';
 import 'zod';
 import '../../../../shared/stack.Dsatjh0B.cjs';
-import '../../../../shared/stack.DtZgEX84.cjs';
+import '../../../../shared/stack.CKc_Bais.cjs';
 
 declare function useThrottle<T>(value: T, wait?: number): T;
 

package/dist/plugins/blog/client/hooks/index.d.mts

@@ -1,9 +1,9 @@
-export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.D2y4gl03.mjs';
+export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.94kN3pEK.mjs';
 export { useDebounce } from '@btst/stack/plugins/client/hooks';
 import '@tanstack/react-query';
 import 'zod';
 import '../../../../shared/stack.Dsatjh0B.mjs';
-import '../../../../shared/stack.DtZgEX84.mjs';
+import '../../../../shared/stack.CKc_Bais.mjs';
 
 declare function useThrottle<T>(value: T, wait?: number): T;