Pre-1.0 — read before upgrading
Patties is 0.x: the framework API, CLI flags, and config shape may change between releases, and backward compatibility is not guaranteed until 1.0.0. Pin an exact version. The authoritative, always-current feed is the GitHub Releases list — this page is the curated, human-readable companion.
Unreleased — next channel ◐ building
Work landed via pending changesets. It will roll into the next version bump on each package's latest tag.
- pattiesUpdate-available banner +
patties upgrade. The CLI prints a cached, channel-aware banner on startup when a newerpattiesis published, andpatties upgradebumps the project to the newest release on its channel. The banner reads from a local cache and refreshes in the background, so it never blocks; opt out with--no-update-checkorNO_UPDATE_NOTIFIER. - pattiesWorkspace-aware React resolution. The dev-server bin + React resolution are now Bun-workspace-aware, so monorepos with a hoisted root
node_modulesload a single copy of React and don't crash SSR with "Invalid hook call." Flat-app resolution is unchanged. - patties
patties-uitruly optional at the CLI. The catalog commands (add/ui/view/update) are lazy-loaded in the dispatcher, sopatties dev/build/deploy/secretno longer fail with "Cannot find module 'patties-ui/schema'" in projects that don't depend on the UI catalog. - create-pattiesRedesigned scaffolder prompt flow (CLI specs 18 + 19). Coding-agent prompt moves earlier; a new project type (frontend / backend / fullstack) drives gated sub-prompts for Patties UI and monorepo and the deploy-target set. Adds
--type,--ui/--no-ui,--monorepo/--no-monorepo,--theme, and acontainertarget (emits aDockerfile). Claude/Codex projects ship the/pattiesskill +/patties-initcommand from one source so they can't drift. Stays zero-dependency.
v0.0.x — Foundations ✓ published
The published 0.0.x line establishes the whole framework: a Bun-native runtime, filesystem routing with React 19 SSR + islands, the build pipeline, the CLI, deploy adapters, the UI catalog, and the optional AI surface.
Framework — patties
- Bun-native runtime. HTTP on
Bun.serve, filesystem discovery onBun.Glob, bundling onBun.build, dev HMR onbun --hot— no Node-era build stack. - Filesystem routing + React 19 SSR. Routes compiled to Bun route patterns; pages stream via
renderToReadableStream; interactive components opt into being client islands with on-demand hydration. - Build-time discovery. Route + island discovery runs once at
buildand is inlined into the production bundle; the server never re-scans the disk at runtime (gated by integration tests). - Thin context + middleware. Handlers take a standard
Requestand a smallPattiesContextand return aResponse; request flow iscompose()middleware. - Adapters. Deploy targets
bunandedgebehind adapters, keeping platform specifics out of the core. - Optional AI + plugins + AGENTS.md. Agents, tools, and jobs on a lazy
@anthropic-ai/sdkpeer dep; plugin hooks for build/dev/jobs; regeneratedCLAUDE.md/AGENTS.mdapp inventory.
Scaffolder — create-patties
- Guided scaffolding.
bunx create-patties@latest my-appstamps a working app with a chosen project type, optional Patties UI starter components, optional monorepo layout, and a deploy target — zero runtime dependencies.
UI catalog — patties-ui
- 60 copy-in components. A shadcn-compatible, copy-in catalog;
patties add <component>stamps source intoapp/components/ui/— never imported from a versioned package. React 19 style (refs as props, noforwardRef), Tailwind v4 + CSS-variable theming, SSR-first with island-by-opt-in.
Versioning & channels
Each package is versioned independently with Changesets and published to npm. Stable releases land on the latest dist-tag; pre-release work lands on next. The Release page shows the live dist-tags straight from the registry.