Turtle web framework
Bun-native React, without the mystery.
Turtle is a compact application framework built around React Server Components, Web Requests and Responses, explicit server/client boundaries, and deterministic Bun builds.
What Turtle gives you
Streaming by defaultServer Components stream through Suspense into SSR, then hydrate from the same Flight data.A filesystem routerStatic, dynamic, catch-all, grouped, and deeply nested routes with layouts and boundaries.Graph-aware HMRReact Refresh for client edits, Flight refresh for server edits, reloads only for structural changes.Web-standard APIsTyped route handlers, request-local context, background work, and application-owned RPC.
The core model
Files under app/ are Server Components unless they begin with "use client". A build scans the route tree and client directives once, emits separate RSC, SSR, browser, and request-runtime graphs, and records deterministic manifests. At request time Turtle matches precomputed route data; it does not rediscover the application.
Turtle deliberately does not implement Server Actions. Mutations belong in typed route handlers or application-owned RPC, where policy, validation, logging, and error projection stay centralized.
Choose a path
- New here? Complete the ten-minute tutorial.
- Building an application? Read routing, rendering, and requests and APIs.
- Operating Turtle? See development, deployment, and the complete reference.