# hejj

> hejj is a fast, offline-first browser homepage with boards of links, notes, lists and widgets.
> Other apps can add a live widget to a user's boards, with the user's consent.

## App widgets (build an integration)

- [The complete spec](https://hejj.net/developers/widgets.md): read this first; it's one file and it's all you need. Connect flows (redirect + PKCE, device code), manifest, push, signed pull, blocks, buttons, limits, common mistakes.
- [Manifest JSON Schema](https://hejj.net/schemas/manifest-1.json)
- [Blocks JSON Schema](https://hejj.net/schemas/blocks-1.json)
- [OpenAPI for the app API](https://hejj.net/schemas/apps-openapi-1.json)
- [Playground](https://hejj.net/developers/playground): validate a manifest or payload and preview it in every theme and size.
- There is no SDK: the API is plain HTTPS + JSON, usable from any language.

## Privacy

Apps never learn who the user is: they get a random per-user, per-app, per-widget grant id. Time zone and language are shared only if the user ticks a box at consent.