Application frames and shells · v0.1.9-0.20260910224508-5b2222e54637

Goshtoso App Shells

Build the frame once, then let each route focus on its work. Choose a frame or shell from the sidebar to explore its live example and integration guide.

View source on GitHub Read the API docs

Choose a frame when you need a consistent page shape

Frames

A frame standardizes the shape of a page without taking over application navigation. componentpage keeps a preview, usage source, named variants, and guidance together so every reference page follows the same reading path.

componentpage Component Page Keep the rendered preview, copyable source, named states, and application guidance in one reference page. Open Component Page ↗

Choose a shell when the product owns the surrounding regions

Shells

A shell owns the regions around a product surface—identity, navigation, responsive behavior, and page lifecycle. Your application still owns routes, permissions, data, and navigation items.

Use componentdocshell to build documentation, consoleshell to build application workspaces, and landingshell to build public pages.

Response model

Fragment support

Only the documentation and console shells expose HTMX fragment responses in v0.1.9-0.20260910224508-5b2222e54637. Component Page is embedded inside a document; Landing Shell renders complete public pages.

For enhanced links, return Layout on ordinary requests and Fragment when HX-Request-Type is partial. Each shell page documents its exact response and out-of-band contract.

Build a custom layout

Combine Navbar, Sidebar, and the other Goshtoso components when your application needs a different layout. The example applications demonstrate navigation, forms, and lists with working server handlers.

Try the example applications