Overview

What Patties is

Patties is a Bun-native full-stack meta-framework that treats Bun as the foundation rather than as a compatibility target.

The framework is built around:

• Bun.serve for HTTP serving
• Bun.Glob for filesystem scanning
• Bun.build for client and server bundling
• React server rendering via renderToReadableStream
• Bun-native dev workflows with bun --hot and bun --watch

What Patties includes

• Filesystem routing compiled to Bun route patterns
• React page rendering
• Client islands with on-demand hydration
• Dev-time HMR wiring
• Build output for Bun and edge targets
• Middleware composition and typed request context
• Config, environment, and dev-time secrets loading
• Optional AI primitives for agents, tools, and jobs
• Plugin hooks for build, dev, jobs, and AGENTS.md

Core mental model

A Patties app is mostly a folder convention plus a small runtime:

• write route modules in app/routes/
• place interactive islands in app/islands/
• add middleware in app/middleware.ts
• define config in patties.config.ts
• use the CLI for dev, build, deploy, and secret management