Git Product home page Git Product logo

fabulous.avalonia's Introduction

Fabulous for Avalonia

build NuGet version NuGet downloads Discord Twitter Follow

Fabulous.Avalonia brings the great development experience of Fabulous to AvaloniaUI, allowing you to take advantage of this UI framework with a tailored declarative UI DSL and clean architecture.

Deploy to any platform supported by Avalonia, such as Android, iOS, macOS, Windows, Linux and more!

MVU Sample
    type Model =
        { Count: int }
    
    type Msg =
        | Increment
        | Decrement
    
    let init () =
        { Count = 0 }
    
    let update msg model =
        match msg with
        | Increment -> { model with Count = model.Count + 1 }
        | Decrement -> { model with Count = model.Count - 1 }
    
    let content model =
        VStack(spacing = 16.) {
            Image("fabulous.png", Stretch.Uniform)
    
            TextBlock($"Count is {model.Count}")
    
            Button("Increment", Increment)
            Button("Decrement", Decrement)
        }
        
    #if MOBILE
        let app model = SingleViewApplication(content model)
    #else
        let app model = DesktopApplication(Window(content model))
    #endif
    
    let create () =
        let program = Program.statefulWithCmd init update |> Program.withView app

        FabulousAppBuilder.Configure(FluentTheme, program)
MVU Component sample
    type Model =
        { Count: int }
    
    type Msg =
        | Increment
        | Decrement
    
    let init () =
        { Count = 0 }
    
    let update msg model =
        match msg with
        | Increment -> { model with Count = model.Count + 1 }
        | Decrement -> { model with Count = model.Count - 1 }
    
    let content model =
        VStack(spacing = 16.) {
            Image("fabulous.png", Stretch.Uniform)
    
            TextBlock($"Count is {model.Count}")
    
            Button("Increment", Increment)
            Button("Decrement", Decrement)
        }
        
     let program = Program.statefulWithCmd init update
    
     let view () =
         Component(program) {
             let! model = Mvu.State
    
 #if MOBILE
             SingleViewApplication(content model)
 #else
             DesktopApplication(Window(content model))
 #endif
         }
    
     let create () =
         FabulousAppBuilder.Configure(FluentTheme, view)

Additionals Controls

We also provide additional binding for Avalonia controls, you can find them in the following packages:

  • Fabulous.Avalonia.DataGrid NuGet version
  • Fabulous.Avalonia.ColorPicker NuGet version
  • Fabulous.Avalonia.ItemsRepeater NuGet version
  • Fabulous.Avalonia.TreeDataGrid NuGet version

Getting Started

You can start your new Fabulous.Avalonia app in a matter of seconds using the dotnet CLI templates.
For a starter guide see our Get Started with Fabulous.Avalonia.

How to use the templates

Using the dotnet CLI, install the templates:

dotnet new install Fabulous.Avalonia.Templates

Then, you will be able to create new Fabulous.Avalonia projects with dotnet new:

Single Project

Single project takes the platform-specific development experiences and abstracts them into a single shared project that can target Android, iOS, Desktop.

dotnet new fabulous-avalonia -n MyApp
  • MyApp
    • Platform
      • Android
      • iOS
      • Desktop

Note: Browser is not supported in single project template.

Multi Project

Multi project takes the platform-specific development and abstracts them into a multiple projects that can target Android, iOS, Desktop, Browser.

dotnet new fabulous-avalonia-multi -n MyApp
  • MyApp
    • MyApp
    • MyApp.Android
    • MyApp.iOS
    • MyApp.Desktop
    • MyApp.Browser

net8.0-ios is not supported on Linux, thus net8.0-ios is excluded from build on a Linux host.

Samples

We have a range of samples to help you get started.

You can find them in the samples repo.

Controls Gallery

To run the Gallery sample app from the command line, navigate to the sample folder and run dotnet run -f net8.0.

cd samples/Gallery
dotnet run -f net8.0

You can also open the solution Fabulous.Avalonia.sln with your favorite IDE(We recommend Rider) and select the platform you want, then press debug to deploy and run the app.

Documentation

The full documentation for Fabulous.Avalonia can be found at docs.fabulous.dev/avalonia.

Other useful links:

Additionally, we have the Fabulous Discord server where you can ask any of your Fabulous related questions.

Supporting Fabulous

The simplest way to show us your support is by giving this project and the Fabulous project a star.

You can also support us by becoming our sponsor on the GitHub Sponsors program.
This is a fantastic way to support all the efforts going into making Fabulous the best declarative UI framework for dotnet.

If you need support see Commercial Support section below.

Contributing

Have you found a bug or have a suggestion of how to enhance Fabulous? Open an issue and we will take a look at it as soon as possible.

Do you want to contribute with a PR? PRs are always welcome, just make sure to create it from the correct branch (main) and follow the Contributor Guide.

For bigger changes, or if in doubt, make sure to talk about your contribution to the team. Either via an issue, GitHub discussion, or reach out to the team either using the Discord server.

Commercial support

If you would like us to provide you with:

  • training and workshops,
  • support services,
  • and consulting services.

Feel free to contact us: [email protected]

fabulous.avalonia's People

Contributors

edgarfgp avatar timlariviere avatar conradroesch avatar kevkov avatar christophschmidpeter avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.