Notre avis

g-sui est un framework Go qui génère des interfaces utilisateur côté serveur, avec composants réutilisables et interactions via WebSocket.

Points forts

Tout le rendu HTML est côté serveur, simplifiant la logique client.
Composants sous forme de fonctions Go renvoyant des chaînes HTML.
Mises à jour en temps réel via WebSocket.
Gestion intégrée des formulaires et des actions serveur.

Limites

Nécessite une bonne connaissance de Go et du rendu serveur.
Pas de support natif pour des frameworks front-end modernes (React, Vue).
La documentation supplémentaire est dispersée dans plusieurs fichiers.

Quand l'utiliser

Utilisez g-sui lorsque vous développez une application web en Go nécessitant peu de JavaScript et une logique serveur centralisée.

Quand l'éviter

Évitez g-sui si vous avez besoin d'une interactivité client riche ou d'intégration avec des bibliothèques front-end populaires.

Exemples

Create a basic g-sui app

Create a g-sui application with a homepage showing 'Hello World' and a second page with a form that submits via server action.

Add a data table

Add a data table to my g-sui project that supports sorting, filtering, and pagination with WebSocket updates.

Implement real-time updates

Implement WebSocket patches in g-sui to push real-time notifications to the UI when new data arrives.

name: g-sui description: Server-rendered Go UI framework. Use when building g-sui applications, creating UI components, handling forms with server actions, using data tables, setting up routes, or implementing WebSocket patches. Triggered by "g-sui", "server-rendered UI", "Go UI framework", form handling, or data collation. allowed-tools: Read, Grep, Glob, Bash, Edit, Write

g-sui Framework

Server-rendered UI framework for Go. All HTML generation, business logic, and state management occur on the server. Interactivity achieved through server actions and WebSocket patches.

Quick Start

package main

import "github.com/michalCapo/g-sui/ui"

func main() {
    app := ui.MakeApp("en")

    app.Page("/", func(ctx *ui.Context) string {
        return app.HTML("Home", "bg-gray-100",
            ui.Div("p-8")(
                ui.Div("text-2xl font-bold")("Hello World"),
            ),
        )
    })

    app.Listen(":8080")
}

Documentation Index

| Topic | File | Description | |-------|------|-------------| | Core Concepts | CORE.md | Architecture, Context, Actions, Targets, server rendering | | UI Components | COMPONENTS.md | Buttons, inputs, forms, tables, alerts, cards, tabs, etc. | | Data Management | DATA.md | Data collation, search, sort, filter, pagination, Excel export | | Server Setup | SERVER.md | App initialization, routes, WebSocket, PWA, assets | | Best Practices | PATTERNS.md | Testing, validation, security, state management |

Core Philosophy

Server-Centric Rendering - All HTML generated server-side as strings
String-Based Components - Components are Go functions returning HTML strings
Action-Based Interactivity - User interactions trigger server handlers returning HTML
WebSocket-Enhanced - Real-time updates via /__ws endpoint

Key Types

type Callable = func(*ui.Context) string  // All handlers return HTML
type Attr struct { ID, Class, Value, OnClick, OnSubmit, ... }  // HTML attributes

Common Imports

import "github.com/michalCapo/g-sui/ui"

Development Commands

go run examples/main.go      # Run example app
go test ./...                # Run all tests
go test ./ui/...             # Test UI package
go build                     # Build project
./deploy                     # Create and push new version tag

Releases

To create a new version release:

./deploy

The deploy script automatically:

Starts at version v0.100 if no tags exist
Increments the minor version by 1 (e.g., v0.100 → v0.101 → v0.102)
Ensures working tree is clean before tagging
Creates an annotated git tag and pushes to remote

Version numbering: v0.XXX format, auto-incremented from v0.100.

Framework g-sui pour Go

Recommandé pour