README.md

Feliz

A fresh retake of the React API in Fable, optimized for happiness.

Here is how it looks like:

module App

open Feliz

[<ReactComponent>]
let counter() =
    let (count, setCount) = React.useState(0)
    Html.div [
        Html.button [
            prop.style [ style.marginRight 5 ]
            prop.onClick (fun _ -> setCount(count + 1))
            prop.text "Increment"
        ]

        Html.button [
            prop.style [ style.marginLeft 5 ]
            prop.onClick (fun _ -> setCount(count - 1))
            prop.text "Decrement"
        ]

        Html.h1 count
    ]

open Browser.Dom

ReactDOM.render(counter(), document.getElementById "root")

Features

• Consistent, lightweight formatting: no more awkward indentation using two lists for every element.
• Discoverable attributes with no more functions, Html attributes or css properties globally available so they are easy to find.
• Proper documentation: each attribute and CSS property
• Full React API support: Feliz aims to support the React API for building components using hooks, context and more.
• Fully Type-safe: no more Margin of obj but instead utilizing a plethora of overloaded functions to account for the overloaded nature of CSS attributes, covering 90%+ of the CSS styles, values and properties.
• Included color list of most commonly used Html colors in the colors module.
• Compatible with the current DSL used in applications.
• Compatible with Femto.
• Approximately Zero bundle size increase where everything function body is erased from the generated javascript unless you actually use said function.

Documentation

Improvements to Fable 3 with respect to Feliz are currently WIP! Please hold tight until we update it and publish a migration guide.

Feliz has extensive documentation at https://zaid-ajaj.github.io/Feliz with live examples along side code samples, check them out and if you have any question, let us know!