ariawanui

AriawanUi

GUI Framework Cross-Platform untuk Developer Indonesia

AriawanUi adalah framework GUI (Graphical User Interface) berbasis Go yang mendukung pengembangan aplikasi desktop dan mobile secara cross-platform. Dibangun dengan fokus pada kemudahan penggunaan, performa tinggi, dan dokumentasi berbahasa Indonesia.

Visi

Menyediakan framework GUI berkualitas tinggi untuk developer Indonesia, dengan:

• Dokumentasi Bahasa Indonesia - Memudahkan developer lokal untuk belajar dan berkontribusi
• API Stabil - Tidak ada breaking changes yang membingungkan
• Cross-Platform - Satu codebase untuk Windows, macOS, Linux, Android, iOS, dan Web
• Performa Tinggi - GPU-accelerated rendering dengan immediate mode architecture
• Komponen Siap Pakai - Library komponen UI yang lengkap dan mudah digunakan

Kenapa AriawanUi?

Platform yang Didukung

Instalasi

go get github.com/agungadiariawan/ariawanui@latest

Quick Start

package main

import (
    "os"

    "github.com/agungadiariawan/ariawanui/app"
    "github.com/agungadiariawan/ariawanui/layout"
    "github.com/agungadiariawan/ariawanui/op"
    "github.com/agungadiariawan/ariawanui/widget/material"
    "github.com/agungadiariawan/ariawanui/font/gofont"
    "github.com/agungadiariawan/ariawanui/text"
)

func main() {
    go func() {
        w := new(app.Window)
        th := material.NewTheme()
        th.Shaper = text.NewShaper(text.WithCollection(gofont.Collection()))

        var ops op.Ops

        for {
            switch e := w.Event().(type) {
            case app.DestroyEvent:
                os.Exit(0)
            case app.FrameEvent:
                gtx := app.NewContext(&ops, e)

                layout.Center.Layout(gtx, func(gtx layout.Context) layout.Dimensions {
                    return material.H1(th, "Halo AriawanUi!").Layout(gtx)
                })

                e.Frame(gtx.Ops)
            }
        }
    }()
    app.Main()
}

Struktur Package

github.com/agungadiariawan/ariawanui/
├── app/        # Window management
├── layout/     # Layout system (Flex, Stack, List)
├── widget/     # UI components
│   └── material/   # Material Design theme
├── op/         # Drawing operations
├── io/         # Event system (keyboard, mouse, touch)
├── text/       # Text rendering
├── font/       # Font management
├── gesture/    # Gesture detection
├── unit/       # Device-independent units
├── f32/        # Float32 math utilities
├── gpu/        # GPU rendering backend
└── shader/     # GPU shaders

Contoh Penggunaan

Button dengan Click Handler

var button widget.Clickable
var count int

// Di dalam event loop:
for button.Clicked(gtx) {
    count++
}

material.Button(th, &button, fmt.Sprintf("Klik: %d", count)).Layout(gtx)

Layout Flex

layout.Flex{
    Axis: layout.Vertical,
}.Layout(gtx,
    layout.Rigid(func(gtx layout.Context) layout.Dimensions {
        return material.H2(th, "Judul").Layout(gtx)
    }),
    layout.Flexed(1, func(gtx layout.Context) layout.Dimensions {
        return material.Body1(th, "Konten...").Layout(gtx)
    }),
)

Text Input

var editor widget.Editor

material.Editor(th, &editor, "Masukkan nama...").Layout(gtx)

Roadmap

Komponen UI (Planned)

• Button variants (primary, secondary, outline)
• Form components (checkbox, radio, select)
• Data table
• Modal/Dialog
• Toast notifications
• Navigation components (navbar, sidebar, tabs)

Example Projects (Planned)

• Terminal emulator
• Admin dashboard
• File manager
• Code editor

Dokumentasi (Planned)

• Tutorial lengkap Bahasa Indonesia
• Video tutorial
• Best practices guide

Kontribusi

Kontribusi dari komunitas sangat diterima! Berikut cara berkontribusi:

Cara Berkontribusi

1. Fork - Klik tombol Fork di kanan atas halaman repo ini
2. Clone - Clone repo hasil fork ke komputer Anda

   git clone https://github.com/USERNAME_ANDA/ariawanui.git
   

3. Branch - Buat branch baru untuk fitur/perbaikan Anda

   git checkout -b fitur-baru
   

4. Code - Tulis kode Anda
5. Test - Pastikan build sukses

   go build ./...
   

6. Commit - Commit dengan pesan yang jelas

   git commit -m "Tambah fitur: deskripsi singkat"
   

7. Push - Push ke repo fork Anda

   git push origin fitur-baru
   

8. Pull Request - Buat Pull Request di GitHub

Apa yang Bisa Dikontribusikan?

Proses Review

Anda buat Pull Request
        ↓
Maintainer review code Anda
        ↓
   ┌────┴────┐
   ↓         ↓
Feedback   Approved
(Revisi)   (Merge)

• Setiap PR akan di-review oleh maintainer
• Maintainer mungkin minta revisi atau klarifikasi
• Setelah approved, PR akan di-merge ke main branch
• Kontributor akan tercatat di contributors list

Code of Conduct

• Gunakan Bahasa Indonesia atau Inggris yang sopan
• Hormati pendapat dan kontribusi orang lain
• Fokus pada kualitas code dan dokumentasi
• Bantu sesama developer Indonesia berkembang

Lisensi

AriawanUi dilisensikan di bawah MIT License / Unlicense (dual license) - Anda bebas menggunakan untuk proyek personal maupun komersial. Lihat file LICENSE untuk detail.

Credits

AriawanUi dibangun di atas Gio, sebuah framework GUI open source yang luar biasa. Terima kasih kepada:

• Elias Naur - Creator Gio
• Gio Contributors - Semua kontributor Gio
• Komunitas Go Indonesia - Inspirasi dan dukungan

Kontak & Komunitas

• Author: Agung Adi Ariawan
• GitHub: @agungadiariawan
• Issues: GitHub Issues

Punya pertanyaan? Buat issue di GitHub atau hubungi langsung!

Dibuat dengan semangat untuk Developer Indonesia

Mari bersama membangun ekosistem GUI development di Indonesia!