Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fsbolero/Bolero

Bolero brings Blazor to F# developers with an easy to use Model-View-Update architecture, HTML combinators, hot reloaded templates, type-safe endpoints, advanced routing and remoting capabilities, and more.
https://github.com/fsbolero/Bolero

blazor bolero fsharp webassembly

Last synced: about 1 month ago
JSON representation

Bolero brings Blazor to F# developers with an easy to use Model-View-Update architecture, HTML combinators, hot reloaded templates, type-safe endpoints, advanced routing and remoting capabilities, and more.

Awesome Lists containing this project

README

        

# Bolero - F# Tools for Blazor

[![Build](https://github.com/fsbolero/Bolero/actions/workflows/build.yml/badge.svg)](https://github.com/fsbolero/Bolero/actions/workflows/build.yml)
[![Nuget](https://img.shields.io/nuget/vpre/Bolero?logo=nuget)](https://nuget.org/packages/Bolero)

Bolero is a set of tools and libraries to run F# applications in WebAssembly using [Blazor](https://blazor.net/).

It includes:

* **HTML** functions using a familiar syntax similar to WebSharper.UI or Elmish.React.
* **Templating** to write HTML in a separate file and bind it to F# using a type provider.
* [**Elmish**](https://elmish.github.io/elmish/) integration: run an Elmish program as a Blazor component, and Blazor components as Elmish views.
* **Routing**: associate the page's current URL with a field in the Elmish model, defined as a discriminated union. Define path parameters directly on this union.
* **Remoting**: define asynchronous functions running on the server and simply call them from the client.
* F#-specific **optimizations**: Bolero strips F# signature data from assemblies to reduce the size of the served application.

## Getting started with Bolero

To get started, you need the following installed:

* .NET SDK 6.0. Download it [here](https://dotnet.microsoft.com/download).

Then, to create and run a sample application:

* Install the Bolero project templates:

```shell
dotnet new -i Bolero.Templates
```
* Create a new project:

```shell
dotnet new bolero-app -o MyBoleroApp
```

* Run it:

```shell
cd MyBoleroApp
dotnet run --project src/MyBoleroApp.Server
```

To learn more, you can check [the documentation](https://fsbolero.io/docs).

## Contributing

Bolero welcomes contributions! If you wish to report issues, propose ideas, or submit pull requests, please use [the issue tracker](https://github.com/intellifactory/bolero). See also [the contributing guide](https://github.com/intellifactory/Bolero/blob/master/CONTRIBUTING.md) to get started on working on this repository.