core/gui

Snider 032c426ac3 feat: initial Wails v3 desktop framework

GUI packages, examples, and documentation for building
desktop applications with Go and web technologies.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-30 08:44:23 +00:00

1.3 KiB

Raw Permalink Blame History

Development Guide

This guide covers how to set up the development environment, build the project, and run the demo.

Prerequisites

Go: Version 1.25 or later.
Node.js & npm: For building the Angular frontend.
Wails Dependencies:
- Linux: libgtk-3-dev, libwebkit2gtk-4.1-dev
- macOS/Windows: Standard development tools (Xcode Command Line Tools / build-essential).

Setup

Clone the repository:

git clone https://github.com/Snider/display.git
cd display

Install Go dependencies:
```
go mod tidy
```
Install Frontend dependencies:
```
cd ui
npm install
cd ..
```

Running the Demo

The project includes a CLI to facilitate development.

Serve Mode (Web Preview)

To start a simple HTTP server that serves the frontend and a mock API:

Build the frontend first:
```
cd ui && npm run build && cd ..
```
Run the serve command:
```
go run ./cmd/demo-cli serve
```
Access the app at http://localhost:8080.

Building the Project

Frontend

cd ui
npm run build

Backend / Application

This project is a library/module. However, it can be tested via the demo CLI or by integrating it into a Wails application entry point.

To run the tests:

go test ./...

1.3 KiB Raw Permalink Blame History