Skip to content
Browse documentation
recipes

Smoothie Starter

Build on a client-rendered Octane/Whisk interface, native routing and a typed HTTP service.

A web foundation, not a product template

Start here for a browser application with a typed backend. An Octane interface uses Whisk components and static styles, native TanStack routing, and a shared Service contract. Its health-check button calls the server through the typed client. No database, model or credentials are needed for the default local app.

Where to make changes

shared/contracts.ts               # endpoint schemas and transport contract
targets/web/src/router.tsx         # native routes and typed Service calls
targets/web/src/main.tsx           # browser root and CSS entry
targets/server/endpoints.ts        # shared endpoint behavior
targets/server/app.ts              # Bun HTTP host and built assets
targets/server/cloudflare.ts       # optional Cloudflare Worker host

Add an operation to the shared contract, implement it on the server, then call it from a page. Keep credentials and database adapters out of shared and browser code. The Services and typed clients chapter explains the APIs.

Choose a native host

BunDefault. Separate Vite/API processes during development; one HTTP host serves the built browser assets.
Cloudflare WorkersOptional request-driven host for the same endpoint bindings and browser assets. Local preview uses workerd.

This is client-side rendering, not SSR. A Cloudflare Worker is an HTTP host, not a Framework background Worker. Keep unknown API paths and missing assets as 404 responses; only HTML page navigations should receive the browser shell.

What you add next

Authentication, persistence, Agent execution and product features are not preinstalled behavior. Add only what your application needs. The optional Cloudflare host uses Elysia's experimental adapter; its bounded endpoint checks do not qualify every Bun dependency for Workers.

Follow Create your first application to start. Use the copied README for host-specific commands and Build and deployment for the reviewed artifact workflow. Recipe selection is not general production support approval.