Build for the web, with the web

Goldar is an experimental, HTML-first framework for TypeScript. It renders useful documents on the server, keeps reads and mutations explicit, and adds browser JavaScript only where an interface needs behavior.

• Get started — build and run the smallest Goldar application.
• Think in Goldar — learn the request, data, action, and view model.
• Learn Typed Handlebars — write templates with TypeScript-backed props, branches, loops, and composition.

A small set of parts

A Goldar application is a router, a set of request-scoped routes, and compiled Handlebars views. Routes own the data they read and the form actions they accept. Templates own presentation. Custom elements are an optional enhancement layer, not the price of receiving HTML.

The result is deliberately close to the platform: URLs describe navigation, forms describe mutations, responses remain ordinary web responses, and Hono is available when the framework’s defaults are not enough.

Choose the right documentation

• Guides teach workflows and mental models using behavior implemented in this repository.
• API Reference records the exact public runtime, compiler, CLI, testing, and language-tooling contracts.
• Developer Notes contain architecture, proposals, and roadmap material. Proposal and roadmap pages are clearly marked because they are not shipped API promises.

Goldar is early-stage software. Its public API is changing, the package is not published to npm, and it is not ready for production use.

When prose and code disagree, the runnable examples and tests are the source of truth.