mirror of
https://github.com/seanhess/hyperbole.git
synced 2024-10-03 16:38:40 +03:00
Haskell interactive serverside web framework inspired by HTMX
ff28b402bf
Feedback Requested: Records-based forms |
||
---|---|---|
.github/workflows | ||
bin | ||
client | ||
example | ||
src | ||
test | ||
.envrc | ||
.gitignore | ||
.hlint.yaml | ||
cabal.project | ||
CHANGELOG.md | ||
flake.lock | ||
flake.nix | ||
fourmolu.yaml | ||
hyperbole.cabal | ||
LICENSE | ||
package-lock.json | ||
package.yaml | ||
README.md |
Hyperbole
Create fully interactive HTML applications with type-safe serverside Haskell. Inspired by HTMX, Elm, and Phoenix LiveView
Learn more about Hyperbole on Hackage
{-# LANGUAGE DeriveAnyClass #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE TypeFamilies #-}
import Data.Text (Text)
import Web.Hyperbole
main = do
run 3000 $ do
liveApp (basicDocument "Example") (page mainPage)
mainPage = do
handle message
load $ do
pure $ do
el bold "My Page"
hyper (Message 1) $ messageView "Hello"
hyper (Message 2) $ messageView "World!"
data Message = Message Int
deriving (Generic, ViewId)
data MessageAction = Louder Text
deriving (Generic, ViewAction)
instance HyperView Message where
type Action Message = MessageAction
message :: Message -> MessageAction -> Eff es (View Message ())
message _ (Louder m) = do
let new = m <> "!"
pure $ messageView new
messageView m = do
el_ $ text m
button (Louder m) id "Louder"
Examples
The example directory contains an app with pages demonstrating various features
- Main
- Simple
- Counter
- CSS Transitions
- Forms
- Sessions
- Redirects
- Lazy Loading and Polling
- Errors
- Contacts (Advanced)
Learn More
View Documentation on Hackage
View on Github
In Production
The NSO uses Hyperbole for the L2 Data creation UI for the DKIST telescope
Local Development
Dependencies with Nix
With nix installed, you can use nix develop
to get a shell with all dependencies installed.
Manual dependency installation
Download and install NPM. On a mac, can be installed via homebrew:
brew install npm
Install client dependencies
cd client
npm install
Recommended: Use direnv
to automatically load environment from .env
brew install direnv
direnv allow
Building
Build JavaScript client
cd client
npx webpack
Run examples
cd example
cabal run
Tests
cabal test
File watching
Run tests, then recompile everything on file change and restart examples
bin/dev