Project · developer-framework
lit-happ
- How you run it
- not recorded
- Holochain version
- 0.2.4
- Activity
- active
- Checked
- 30 October 2026
What is lit-happ and what is it for?
lit-happ is a software framework for developers who build the web interface of a Holochain app with Lit. It supplies the ViewModel layer that sits between a Holochain app's data and its web components, so screens can be written without handling conductor calls directly.
lit-happ is a developer framework for building the web interface of a Holochain app with Lit, a JavaScript library for web components. Its maintainer describes it as the missing piece between a Holochain app's data and its screen: Holochain DNAs act as the model and Lit elements as the view, and lit-happ supplies the ViewModels that format DNA data for those views, so a view does not need to know how the underlying calls work.
The framework is published as two npm packages. cell-proxy provides classes for talking to a running Holochain conductor and calling zome functions on its cells, and lit-happ builds on that with ViewModel classes and helper elements. A ViewModel presents a Perspective, a deliberately partial slice of the data available, reflecting that no node holds the full picture at once, and binds it to Lit's reactive properties so a screen updates as the data changes.
The repository includes a playground of small example apps under /example, with zomes for a single integer, a single real number and a label, combined into two DNAs. npm run devtest starts a basic happ with two DNAs in three roles, and npm run devtest:clone starts a variant with two clonable roles; both are the quickest way to see the framework in use. Learn more at the repository.
How to get it
As a library
- npm i @ddd-qc/lit-happ
- npm i @ddd-qc/cell-proxy
- Use the framework in your own web project by defining ViewModel subclasses for your app's DNAs and zomes, or start from the example happs in the repository's /example folder
Questions people ask
- What does lit-happ need in order to run?
- It is installed from npm together with its cell-proxy companion package, which handles communication with a Holochain conductor; the ViewModels are held by a host element that also holds the conductor app proxy. source
- Is lit-happ an app I can open and use?
- No. It is a set of npm packages that developers add to their own project while building the web interface of a Holochain app. source
From 3 public sources, checked 23 September 2026.
Try lit-happ
- Code on GitHubOpen on GitHub ↗Last change 7 September 2026.
- ReleaseNo GitHub release recorded.
- The project's own files do not say how it is run.
Details & sources
- Source
- ddd-mtl/lit-happ
Evidence
- Last change
- api.github.com/repos/ddd-mtl/lit-happlisted by a third party · seen since 20 October 2026 · github.repository@1
- Activity
- api.github.com/repos/ddd-mtl/lit-happlisted by a third party · seen since 20 October 2026 · liveness@1
Compatibility
- hdk
- 0.2.4 · example/Cargo.toml @ 29a822c
- hdi
- 0.3.4 · example/Cargo.toml @ 29a822c
- holochain-client
- —
- happ.yaml
- present · example/workdir/happ.yaml @ 29a822c
- web-happ.yaml
- absent