Monomer

<h1 align="center">Monomer</h1> <h3 align="center">A cross-platform GUI library for Haskell</h3> <p align="center"> <img src="https://raw.githubusercontent.com/fjvallarino/monomer/main/assets/images/monomer-logo.svg" height=250 width=250 alt="Logo" /> </p> <p align="center"> <a href="https://github.com/fjvallarino/monomer/actions"> <img src="https://img.shields.io/github/actions/workflow/status/fjvallarino/monomer/build.yml?branch=main" alt="CI badge" /> </a> <a href="https://haskell.org"> <img src="https://img.shields.io/badge/Made%20in-Haskell-%235e5086?logo=haskell&style=flat-square" alt="made with Haskell"/> </a> <a href="https://haskell.org"> <img src="https://img.shields.io/github/license/fjvallarino/monomer?color=111%09193%0965%09" alt="BSD-3-Clause"/> </a> </p> <br/>

An easy to use, cross platform, GUI library for writing native Haskell applications.

Monomer provides a framework similar to the Elm Architecture, allowing the creation of GUIs using an extensible set of widgets with pure Haskell.

Objectives

• Be easy to learn and use.
• Be extensible with custom widgets.
• Run on Windows, Linux and macOS.
• Have good documentation.
• Have good examples.

These are not objectives for this project

• Have a native look and feel.

Why would you want to use this library?

• You want to write your application in Haskell.
• You want to write a native, not web based, application.

Documentation

Setup

You can read how to setup your environment here.

Tutorials

Introductory tutorials are available:

• 01 - Basics
• 02 - Styling
• 03 - Life cycle
• 04 - Tasks
• 05 - Producers
• 06 - Composite
• 07 - Custom widgets
• 08 - Themes

Examples

Beyond the tutorials, a few real world like examples are available:

• Todo
• Books
• Ticker
• Generative
• Custom OpenGL

Haddock

You can read the source code's documentation here.

Design decisions

In case you wonder why some choices were made, you can read here.

Roadmap

• Stability and performance.
• Mobile support.

Project status

Although there has not been a lot of activity in the past year, the project is still active.

I may take some time to respond to issues while I work on features I want to add to Monomer.

Useful extensions

• Hagrid, a flexible datagrid widget.
• Monomer Flatpak Example, an example of how to package Monomer applications on Linux, using Flatpak.

Contributing

PRs are welcome!

If possible, keep them small and focused. If you are planning on making a large change, please submit an issue first so we can agree on a solution.

License

This library is licensed under the BSD-3 license.

Fonts used in the examples:

• Roboto, licensed under the Apache license.
• Remix Icon, licensed under the Apache license.

Acknowledgments

• Thanks to Ghislaine Guerin for UX advice.
• Thanks to Mikko Mononen for the amazing nanovg library.