UI Docs Deploy now

The UI moin runs on

Native HTML, CSS and JS for any stack. Your code, not a library. Experimental: it can change at any time.

Get started

1. Get the folder

curl -L https://github.com/axadrn/moin/archive/main.tar.gz | tar xz --strip-components=1 moin-main/ui
<link rel="stylesheet" href="ui/moin.css">
<script src="ui/moin.js"></script>

3. Copy a block

Open the blocks, copy a whole page, and change what you need. Use it as plain HTML, or turn it into components of your stack.

Where everything lives

ui/
├── moin.css       loads everything
├── moin.js        small behaviors
├── theme.css      colors, spacing, corners
├── layout.css     stack, row, grid, page
├── components/    one CSS file per component
├── icons.css      icon classes
├── icons/         SVG files
├── docs/          one page per component
├── examples/      one file per example
├── blocks/        whole pages to copy
├── CHANGELOG.md   what changed
├── LICENSE        the license
└── README.md

How it is built

The rules

In your language

The same two buttons in each one. Every language prints this HTML.

HTML

<div class="moin-row" data-gap="2">
  <button type="button" class="moin-button" data-kind="primary">Deploy</button>
  <button type="button" class="moin-button">Cancel</button>
</div>

templ

type Kind string

const Primary Kind = "primary"

type ButtonProps struct {
	Kind  Kind
	Attrs templ.Attributes
}

templ Button(p ButtonProps) {
	<button
		type="button"
		class="moin-button"
		if p.Kind != "" {
			data-kind={ string(p.Kind) }
		}
		{ p.Attrs... }
	>
		{ children... }
	</button>
}

templ Actions() {
	<div class="moin-row" data-gap="2">
		@Button(ButtonProps{Kind: Primary}) {
			Deploy
		}
		@Button(ButtonProps{}) {
			Cancel
		}
	</div>
}

Go

const page = `
{{define "button"}}<button type="button" class="moin-button"{{if .Kind}} data-kind="{{.Kind}}"{{end}}>{{.Label}}</button>{{end}}

<div class="moin-row" data-gap="2">
  {{template "button" .Deploy}}
  {{template "button" .Cancel}}
</div>`

type Button struct{ Kind, Label string }

func main() {
	template.Must(template.New("page").Parse(page)).Execute(os.Stdout, map[string]Button{
		"Deploy": {Kind: "primary", Label: "Deploy"},
		"Cancel": {Label: "Cancel"},
	})
}

Ruby

require "erb"
include ERB::Util

def button(label, kind: nil)
  data = kind ? %( data-kind="#{h kind}") : ""
  %(<button type="button" class="moin-button"#{data}>#{h label}</button>)
end

puts ERB.new(<<~PAGE).result
  <div class="moin-row" data-gap="2">
    <%= button("Deploy", kind: "primary") %>
    <%= button("Cancel") %>
  </div>
PAGE

Python

{% macro button(label, kind="") -%}
<button type="button" class="moin-button"{% if kind %} data-kind="{{ kind }}"{% endif %}>{{ label }}</button>
{%- endmacro %}

<div class="moin-row" data-gap="2">
  {{ button("Deploy", kind="primary") }}
  {{ button("Cancel") }}
</div>

PHP

<?php
function button(string $label, string $kind = ''): string {
    $data = $kind ? ' data-kind="' . htmlspecialchars($kind) . '"' : '';
    return '<button type="button" class="moin-button"' . $data . '>' . htmlspecialchars($label) . '</button>';
}
?>
<div class="moin-row" data-gap="2">
  <?= button('Deploy', kind: 'primary') ?>
  <?= button('Cancel') ?>
</div>

Rust

use maud::{html, Markup};

fn button(label: &str, kind: Option<&str>) -> Markup {
    html! { button.moin-button type="button" data-kind=[kind] { (label) } }
}

fn actions() -> Markup {
    html! {
        .moin-row data-gap="2" {
            (button("Deploy", Some("primary")))
            (button("Cancel", None))
        }
    }
}