From 1529e55d254ae8815cbada742473a3b29cc26b67 Mon Sep 17 00:00:00 2001 From: Egutierrez Date: Sun, 22 Mar 2026 19:00:07 +0100 Subject: [PATCH] feat: agregar agente build-wails para apps desktop MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Nuevo agente para crear y compilar aplicaciones Wails (Go + React). Soporta compilación cross-platform: Linux, Windows, macOS. Incluye script de creación de proyecto con DevFactory y frontend-lib integrados. --- .claude/agents/build-wails/SKILL.md | 510 ++++++++++++++++++ .../templates/Dockerfile.wails-builder | 47 ++ .claude/agents/build-wails/templates/Makefile | 134 +++++ .claude/agents/build-wails/templates/app.go | 111 ++++ .../templates/create-wails-project.sh | 210 ++++++++ .../build-wails/templates/go.work.template | 8 + .claude/agents/build-wails/templates/main.go | 71 +++ .../agents/build-wails/templates/wails.json | 22 + 8 files changed, 1113 insertions(+) create mode 100644 .claude/agents/build-wails/SKILL.md create mode 100644 .claude/agents/build-wails/templates/Dockerfile.wails-builder create mode 100644 .claude/agents/build-wails/templates/Makefile create mode 100644 .claude/agents/build-wails/templates/app.go create mode 100755 .claude/agents/build-wails/templates/create-wails-project.sh create mode 100644 .claude/agents/build-wails/templates/go.work.template create mode 100644 .claude/agents/build-wails/templates/main.go create mode 100644 .claude/agents/build-wails/templates/wails.json diff --git a/.claude/agents/build-wails/SKILL.md b/.claude/agents/build-wails/SKILL.md new file mode 100644 index 0000000..5abb498 --- /dev/null +++ b/.claude/agents/build-wails/SKILL.md @@ -0,0 +1,510 @@ +--- +name: build-wails +description: Agente para crear y compilar aplicaciones desktop con Wails (Go + React). Soporta Linux, Windows y macOS. +model: sonnet +tools: Read, Write, Bash, Glob, Grep, Edit +mcpServers: + - gitea: + type: stdio + command: gitea-mcp + args: + - -t + - stdio + - --host + - "${GITEA_URL}" + - --token + - "${GITEA_TOKEN}" +--- + +# Agente Build Wails + +Eres un experto en Wails v2, el framework para crear aplicaciones desktop con Go backend y frontend web (React/Vue/Svelte). + +## Tu entorno + +- **Wails**: v2.9+ +- **Go**: 1.22+ +- **Frontend**: React 19 + TypeScript + Vite + Tailwind +- **Librería frontend**: `@anthropic/frontend-lib` (via pnpm link) +- **Librería backend**: DevFactory (via go.work) + +## Capacidades + +### Inicialización de proyectos +- Crear proyecto Wails desde cero +- Configurar con React + TypeScript + Vite +- Integrar con frontend-lib y backend-lib + +### Compilación +- **Linux**: AMD64, ARM64 +- **Windows**: AMD64 (cross-compile desde Linux) +- **macOS**: AMD64, ARM64 (requiere macOS o cross-compile) + +### Desarrollo +- Hot reload con `wails dev` +- Debugging con DevTools +- Bindings automáticos Go ↔ TypeScript + +### Empaquetado +- NSIS installer (Windows) +- AppImage/deb/rpm (Linux) +- DMG/pkg (macOS) + +## Estructura de proyecto Wails + +``` +mi-wails-app/ +├── main.go # Entry point +├── app.go # Lógica de la aplicación (métodos expuestos al frontend) +├── go.mod +├── go.sum +├── go.work # Vincula devfactory localmente +├── wails.json # Configuración de Wails +├── build/ # Assets de build (iconos, manifests) +│ ├── appicon.png +│ ├── windows/ +│ │ └── icon.ico +│ └── linux/ +│ └── icon.png +└── frontend/ # Frontend React + ├── src/ + │ ├── App.tsx + │ ├── main.tsx + │ └── wailsjs/ # Bindings generados automáticamente + │ ├── go/ + │ └── runtime/ + ├── index.html + ├── package.json + ├── vite.config.ts + └── tailwind.config.js +``` + +## Flujo de trabajo + +### Crear proyecto nuevo + +1. **Verificar requisitos**: + ```bash + wails doctor + ``` + +2. **Crear proyecto**: + ```bash + wails init -n mi-app -t react-ts + ``` + +3. **Configurar go.work para DevFactory**: + ```bash + cd mi-app + go work init + go work use . ~/.local_agentes/backend + ``` + +4. **Configurar pnpm link para frontend-lib**: + ```bash + cd frontend + pnpm add @anthropic/frontend-lib@link:~/.local_agentes/frontend/frontend + ``` + +5. **Actualizar wails.json**: + ```json + { + "frontend:install": "pnpm install", + "frontend:build": "pnpm build", + "frontend:dev:watcher": "pnpm dev" + } + ``` + +### Desarrollo + +```bash +# Modo desarrollo con hot reload +wails dev + +# Con DevTools abiertos +wails dev -devtools + +# Solo generar bindings +wails generate module +``` + +### Compilación + +```bash +# Linux (arquitectura actual) +wails build + +# Linux AMD64 +wails build -platform linux/amd64 + +# Windows (cross-compile desde Linux) +wails build -platform windows/amd64 + +# Ambos +wails build -platform linux/amd64,windows/amd64 + +# Con NSIS installer (Windows) +wails build -platform windows/amd64 -nsis + +# Con compresión UPX +wails build -upx + +# Producción optimizada +wails build -clean -trimpath -ldflags="-s -w" +``` + +## Templates + +### wails.json completo + +```json +{ + "$schema": "https://wails.io/schemas/config.v2.json", + "name": "mi-app", + "outputfilename": "mi-app", + "frontend:dir": "frontend", + "frontend:install": "pnpm install", + "frontend:build": "pnpm build", + "frontend:dev:watcher": "pnpm dev", + "frontend:dev:serverUrl": "auto", + "wailsjsdir": "frontend/src/wailsjs", + "author": { + "name": "Lucas", + "email": "lucas@example.com" + }, + "info": { + "companyName": "Mi Empresa", + "productName": "Mi App", + "productVersion": "1.0.0", + "copyright": "Copyright 2024", + "comments": "Aplicación desktop con Wails" + } +} +``` + +### main.go con DevFactory + +```go +package main + +import ( + "embed" + + "github.com/wailsapp/wails/v2" + "github.com/wailsapp/wails/v2/pkg/options" + "github.com/wailsapp/wails/v2/pkg/options/assetserver" + "github.com/wailsapp/wails/v2/pkg/options/linux" + "github.com/wailsapp/wails/v2/pkg/options/windows" +) + +//go:embed all:frontend/dist +var assets embed.FS + +func main() { + app := NewApp() + + err := wails.Run(&options.App{ + Title: "Mi App", + Width: 1280, + Height: 800, + MinWidth: 800, + MinHeight: 600, + AssetServer: &assetserver.Options{ + Assets: assets, + }, + BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1}, + OnStartup: app.startup, + OnShutdown: app.shutdown, + Bind: []interface{}{ + app, + }, + // Opciones específicas de Windows + Windows: &windows.Options{ + WebviewIsTransparent: false, + WindowIsTranslucent: false, + DisableWindowIcon: false, + }, + // Opciones específicas de Linux + Linux: &linux.Options{ + ProgramName: "mi-app", + }, + }) + + if err != nil { + println("Error:", err.Error()) + } +} +``` + +### app.go con DevFactory + +```go +package main + +import ( + "context" + + "github.com/lucasdataproyects/devfactory/core" + "github.com/lucasdataproyects/devfactory/shell" +) + +type App struct { + ctx context.Context +} + +func NewApp() *App { + return &App{} +} + +func (a *App) startup(ctx context.Context) { + a.ctx = ctx +} + +func (a *App) shutdown(ctx context.Context) { + // Cleanup +} + +// Método expuesto al frontend +func (a *App) Greet(name string) string { + return core.Ok("Hello " + name).UnwrapOr("Error") +} + +// Ejemplo con HTTP usando DevFactory +func (a *App) FetchData(url string) string { + client := shell.NewHTTPClient() + result := client.Get(url) + return result.UnwrapOr("Error fetching data") +} +``` + +### Frontend con frontend-lib + +```tsx +// frontend/src/App.tsx +import { useState } from 'react' +import { Button, Card, Input } from '@anthropic/frontend-lib' +import { Greet } from './wailsjs/go/main/App' + +function App() { + const [name, setName] = useState('') + const [greeting, setGreeting] = useState('') + + const handleGreet = async () => { + const result = await Greet(name) + setGreeting(result) + } + + return ( +
+ +

Mi App Wails

+ +
+ setName(e.target.value)} + /> + + + + {greeting && ( +

{greeting}

+ )} +
+ +
+ ) +} + +export default App +``` + +## Requisitos de compilación + +### Linux (nativo) +```bash +# Debian/Ubuntu +sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev + +# Fedora +sudo dnf install gtk3-devel webkit2gtk4.0-devel + +# Arch +sudo pacman -S gtk3 webkit2gtk +``` + +### Windows (cross-compile desde Linux) +```bash +# Instalar MinGW-w64 +sudo apt install gcc-mingw-w64-x86-64 + +# Instalar NSIS para instaladores +sudo apt install nsis + +# Variables de entorno +export CGO_ENABLED=1 +export GOOS=windows +export GOARCH=amd64 +export CC=x86_64-w64-mingw32-gcc +``` + +### Docker para cross-compile +```dockerfile +FROM ghcr.io/nicholasjackson/wails-build:latest + +WORKDIR /app +COPY . . + +# Build para todas las plataformas +RUN wails build -platform linux/amd64 +RUN wails build -platform windows/amd64 +``` + +## Comandos + +### Desarrollo +```bash +# Doctor - verificar instalación +wails doctor + +# Nuevo proyecto +wails init -n nombre -t react-ts + +# Desarrollo con hot reload +wails dev + +# Generar bindings +wails generate module +``` + +### Build +```bash +# Build por defecto +wails build + +# Build limpio +wails build -clean + +# Build optimizado +wails build -clean -trimpath -ldflags="-s -w" + +# Con UPX (compresión) +wails build -upx + +# Cross-compile Windows +wails build -platform windows/amd64 + +# Con instalador NSIS +wails build -platform windows/amd64 -nsis +``` + +### Utilidades +```bash +# Actualizar Wails +go install github.com/wailsapp/wails/v2/cmd/wails@latest + +# Ver versión +wails version + +# Limpiar cache +wails build -clean +``` + +## Integración con tus agentes + +### Con frontend-lib +```bash +# En el frontend del proyecto Wails +cd frontend +pnpm add @anthropic/frontend-lib@link:~/.local_agentes/frontend/frontend + +# Usar componentes +import { Button, DataTable } from '@anthropic/frontend-lib' +``` + +### Con backend-lib (DevFactory) +```bash +# En la raíz del proyecto Wails +go work init +go work use . ~/.local_agentes/backend + +# Usar en app.go +import "github.com/lucasdataproyects/devfactory/core" +import "github.com/lucasdataproyects/devfactory/shell" +``` + +### Con docker +```bash +# Usar el agente docker para containerizar el build +# Ver: docker/templates/Dockerfile.wails +``` + +### Con gitea +```bash +# Crear repo para el proyecto +# Subir releases como attachments en Gitea +``` + +## Troubleshooting + +### "wails: command not found" +```bash +go install github.com/wailsapp/wails/v2/cmd/wails@latest +export PATH=$PATH:$(go env GOPATH)/bin +``` + +### Error de WebKit en Linux +```bash +sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev +``` + +### Cross-compile Windows falla +```bash +# Verificar MinGW +x86_64-w64-mingw32-gcc --version + +# Si no existe +sudo apt install gcc-mingw-w64-x86-64 +``` + +### Frontend no actualiza en dev +```bash +# Limpiar y reiniciar +cd frontend && rm -rf node_modules && pnpm install +wails dev +``` + +## Ejemplos de solicitudes + +### "Crea un proyecto Wails con mis librerías" +1. `wails init -n mi-app -t react-ts` +2. Configurar go.work con DevFactory +3. Configurar pnpm link con frontend-lib +4. Actualizar wails.json para pnpm +5. Verificar con `wails dev` + +### "Compila para Windows" +1. Verificar MinGW instalado +2. `wails build -platform windows/amd64` +3. El ejecutable está en `build/bin/` + +### "Crea un instalador para Windows" +1. Verificar NSIS instalado +2. `wails build -platform windows/amd64 -nsis` +3. El instalador está en `build/bin/` + +### "Compila para producción" +1. `wails build -clean -trimpath -ldflags="-s -w" -upx` +2. Tamaño reducido ~50% +3. Listo para distribución + +## Notas + +- Wails v2 requiere Go 1.18+, recomendado 1.22+ +- El frontend se embebe en el binario via `//go:embed` +- Los bindings Go ↔ TS se generan automáticamente +- Cross-compile a macOS solo funciona desde macOS +- UPX reduce tamaño pero puede causar falsos positivos en antivirus diff --git a/.claude/agents/build-wails/templates/Dockerfile.wails-builder b/.claude/agents/build-wails/templates/Dockerfile.wails-builder new file mode 100644 index 0000000..aaeafbc --- /dev/null +++ b/.claude/agents/build-wails/templates/Dockerfile.wails-builder @@ -0,0 +1,47 @@ +# Dockerfile para compilar proyectos Wails en CI/CD +# Soporta Linux AMD64 y Windows AMD64 (cross-compile) +# +# Uso: +# docker build -t wails-builder -f Dockerfile.wails-builder . +# docker run -v $(pwd):/app wails-builder make build-all + +FROM golang:1.22-bookworm + +# Evitar prompts interactivos +ENV DEBIAN_FRONTEND=noninteractive + +# Instalar dependencias de sistema +RUN apt-get update && apt-get install -y --no-install-recommends \ + # Wails/Linux dependencies + libgtk-3-dev \ + libwebkit2gtk-4.0-dev \ + # Windows cross-compile + gcc-mingw-w64-x86-64 \ + # NSIS para instaladores Windows + nsis \ + # Node.js + nodejs \ + npm \ + # Utilidades + git \ + ca-certificates \ + && rm -rf /var/lib/apt/lists/* + +# Instalar pnpm +RUN npm install -g pnpm + +# Instalar Wails +RUN go install github.com/wailsapp/wails/v2/cmd/wails@latest + +# Instalar UPX para compresión (opcional) +RUN apt-get update && apt-get install -y --no-install-recommends upx \ + && rm -rf /var/lib/apt/lists/* + +# Variables de entorno para cross-compile +ENV PATH="/go/bin:${PATH}" +ENV CGO_ENABLED=1 + +WORKDIR /app + +# Entry point por defecto +CMD ["make", "build-all"] diff --git a/.claude/agents/build-wails/templates/Makefile b/.claude/agents/build-wails/templates/Makefile new file mode 100644 index 0000000..7ebf5b4 --- /dev/null +++ b/.claude/agents/build-wails/templates/Makefile @@ -0,0 +1,134 @@ +# Makefile para proyecto Wails +# Uso: make [target] + +APP_NAME := $(shell basename $(CURDIR)) +VERSION := $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev") +BUILD_DIR := build/bin +LDFLAGS := -ldflags="-s -w -X main.Version=$(VERSION)" + +# Colores +GREEN := \033[0;32m +YELLOW := \033[1;33m +NC := \033[0m + +.PHONY: help dev build build-linux build-windows build-all clean install doctor + +help: ## Mostrar esta ayuda + @grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "$(GREEN)%-20s$(NC) %s\n", $$1, $$2}' + +# ============================================ +# DESARROLLO +# ============================================ + +dev: ## Iniciar en modo desarrollo con hot reload + @echo "$(GREEN)Starting dev mode...$(NC)" + wails dev + +dev-debug: ## Desarrollo con DevTools abiertos + @echo "$(GREEN)Starting dev mode with DevTools...$(NC)" + wails dev -devtools + +generate: ## Generar bindings Go <-> TypeScript + @echo "$(GREEN)Generating bindings...$(NC)" + wails generate module + +# ============================================ +# BUILD +# ============================================ + +build: ## Build para la plataforma actual + @echo "$(GREEN)Building for current platform...$(NC)" + wails build $(LDFLAGS) + +build-prod: ## Build optimizado para producción + @echo "$(GREEN)Building optimized for production...$(NC)" + wails build -clean -trimpath $(LDFLAGS) + +build-linux: ## Build para Linux AMD64 + @echo "$(GREEN)Building for Linux AMD64...$(NC)" + wails build -platform linux/amd64 -clean -trimpath $(LDFLAGS) + +build-linux-arm: ## Build para Linux ARM64 + @echo "$(GREEN)Building for Linux ARM64...$(NC)" + wails build -platform linux/arm64 -clean -trimpath $(LDFLAGS) + +build-windows: ## Build para Windows AMD64 (cross-compile) + @echo "$(GREEN)Building for Windows AMD64...$(NC)" + @echo "$(YELLOW)Requires: gcc-mingw-w64-x86-64$(NC)" + wails build -platform windows/amd64 -clean -trimpath $(LDFLAGS) + +build-windows-nsis: ## Build para Windows con instalador NSIS + @echo "$(GREEN)Building Windows installer...$(NC)" + @echo "$(YELLOW)Requires: nsis$(NC)" + wails build -platform windows/amd64 -nsis -clean -trimpath $(LDFLAGS) + +build-all: build-linux build-windows ## Build para Linux y Windows + @echo "$(GREEN)All builds completed!$(NC)" + @ls -lah $(BUILD_DIR)/ + +build-upx: ## Build con compresión UPX + @echo "$(GREEN)Building with UPX compression...$(NC)" + @echo "$(YELLOW)Note: May trigger antivirus false positives$(NC)" + wails build -upx -clean -trimpath $(LDFLAGS) + +# ============================================ +# UTILIDADES +# ============================================ + +clean: ## Limpiar archivos de build + @echo "$(GREEN)Cleaning build artifacts...$(NC)" + rm -rf $(BUILD_DIR) + rm -rf frontend/dist + rm -rf frontend/node_modules/.vite + +install-deps: ## Instalar dependencias del frontend + @echo "$(GREEN)Installing frontend dependencies...$(NC)" + cd frontend && pnpm install + +update-deps: ## Actualizar dependencias + @echo "$(GREEN)Updating dependencies...$(NC)" + go get -u ./... + cd frontend && pnpm update + +doctor: ## Verificar instalación de Wails + @echo "$(GREEN)Running Wails doctor...$(NC)" + wails doctor + +# ============================================ +# CROSS-COMPILE SETUP +# ============================================ + +setup-windows-cross: ## Instalar herramientas para cross-compile a Windows + @echo "$(GREEN)Installing Windows cross-compile tools...$(NC)" + sudo apt-get update + sudo apt-get install -y gcc-mingw-w64-x86-64 nsis + +setup-linux-deps: ## Instalar dependencias de Linux para Wails + @echo "$(GREEN)Installing Linux dependencies...$(NC)" + sudo apt-get update + sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev + +# ============================================ +# RELEASE +# ============================================ + +release: build-all ## Crear release con todos los binarios + @echo "$(GREEN)Creating release package...$(NC)" + @mkdir -p release + @cp $(BUILD_DIR)/$(APP_NAME) release/$(APP_NAME)-$(VERSION)-linux-amd64 2>/dev/null || true + @cp $(BUILD_DIR)/$(APP_NAME).exe release/$(APP_NAME)-$(VERSION)-windows-amd64.exe 2>/dev/null || true + @cd release && sha256sum * > checksums.txt + @echo "$(GREEN)Release files:$(NC)" + @ls -lah release/ + +# ============================================ +# INFO +# ============================================ + +info: ## Mostrar información del proyecto + @echo "App: $(APP_NAME)" + @echo "Version: $(VERSION)" + @echo "Go: $(shell go version)" + @echo "Wails: $(shell wails version 2>/dev/null || echo 'not installed')" + @echo "Node: $(shell node --version 2>/dev/null || echo 'not installed')" + @echo "pnpm: $(shell pnpm --version 2>/dev/null || echo 'not installed')" diff --git a/.claude/agents/build-wails/templates/app.go b/.claude/agents/build-wails/templates/app.go new file mode 100644 index 0000000..9693795 --- /dev/null +++ b/.claude/agents/build-wails/templates/app.go @@ -0,0 +1,111 @@ +package main + +import ( + "context" + "fmt" + "runtime" + + "github.com/lucasdataproyects/devfactory/core" + "github.com/wailsapp/wails/v2/pkg/runtime" +) + +// App struct - métodos públicos se exponen al frontend +type App struct { + ctx context.Context +} + +// NewApp crea una nueva instancia de App +func NewApp() *App { + return &App{} +} + +// startup se llama cuando la app inicia +func (a *App) startup(ctx context.Context) { + a.ctx = ctx +} + +// domReady se llama cuando el DOM está listo +func (a *App) domReady(ctx context.Context) { + // Inicializaciones que requieren el DOM +} + +// shutdown se llama cuando la app se cierra +func (a *App) shutdown(ctx context.Context) { + // Cleanup resources +} + +// ============================================ +// MÉTODOS EXPUESTOS AL FRONTEND +// ============================================ + +// Greet retorna un saludo +func (a *App) Greet(name string) string { + return fmt.Sprintf("Hello %s, from Go!", name) +} + +// GetSystemInfo retorna información del sistema +func (a *App) GetSystemInfo() map[string]string { + return map[string]string{ + "os": runtime.GOOS, + "arch": runtime.GOARCH, + "cpus": fmt.Sprintf("%d", runtime.NumCPU()), + "goVersion": runtime.Version(), + } +} + +// OpenFileDialog abre un diálogo para seleccionar archivo +func (a *App) OpenFileDialog() core.Result[string] { + file, err := runtime.OpenFileDialog(a.ctx, runtime.OpenDialogOptions{ + Title: "Seleccionar archivo", + Filters: []runtime.FileFilter{ + {DisplayName: "Todos los archivos", Pattern: "*.*"}, + }, + }) + if err != nil { + return core.Err[string](err) + } + return core.Ok(file) +} + +// SaveFileDialog abre un diálogo para guardar archivo +func (a *App) SaveFileDialog(defaultFilename string) core.Result[string] { + file, err := runtime.SaveFileDialog(a.ctx, runtime.SaveDialogOptions{ + Title: "Guardar archivo", + DefaultFilename: defaultFilename, + }) + if err != nil { + return core.Err[string](err) + } + return core.Ok(file) +} + +// ShowMessage muestra un mensaje al usuario +func (a *App) ShowMessage(title, message string) { + runtime.MessageDialog(a.ctx, runtime.MessageDialogOptions{ + Type: runtime.InfoDialog, + Title: title, + Message: message, + }) +} + +// ShowError muestra un error al usuario +func (a *App) ShowError(title, message string) { + runtime.MessageDialog(a.ctx, runtime.MessageDialogOptions{ + Type: runtime.ErrorDialog, + Title: title, + Message: message, + }) +} + +// Confirm muestra un diálogo de confirmación +func (a *App) Confirm(title, message string) bool { + result, _ := runtime.MessageDialog(a.ctx, runtime.MessageDialogOptions{ + Type: runtime.QuestionDialog, + Title: title, + Message: message, + Buttons: []string{"Sí", "No"}, + DefaultButton: "Sí", + CancelButton: "No", + }) + return result == "Sí" +} diff --git a/.claude/agents/build-wails/templates/create-wails-project.sh b/.claude/agents/build-wails/templates/create-wails-project.sh new file mode 100755 index 0000000..2b6d0dd --- /dev/null +++ b/.claude/agents/build-wails/templates/create-wails-project.sh @@ -0,0 +1,210 @@ +#!/bin/bash +# Script para crear un nuevo proyecto Wails con DevFactory + Frontend_Library +# Uso: ./create-wails-project.sh [directorio-destino] + +set -e + +# ============================================ +# CONFIGURACIÓN +# ============================================ +PROJECT_NAME="${1:-mi-wails-app}" +DEST_DIR="${2:-.}" +FULL_PATH="$DEST_DIR/$PROJECT_NAME" + +DEVFACTORY_PATH="$HOME/.local_agentes/backend" +FRONTEND_LIB_PATH="$HOME/.local_agentes/frontend/frontend" +TEMPLATES_PATH="$(dirname "$0")" + +# Colores +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +NC='\033[0m' + +log() { echo -e "${GREEN}[✓]${NC} $1"; } +warn() { echo -e "${YELLOW}[!]${NC} $1"; } +error() { echo -e "${RED}[✗]${NC} $1"; exit 1; } +info() { echo -e "${BLUE}[i]${NC} $1"; } + +# ============================================ +# VALIDACIONES +# ============================================ +info "Verificando requisitos..." + +if ! command -v wails &> /dev/null; then + error "Wails no está instalado. Ejecuta: go install github.com/wailsapp/wails/v2/cmd/wails@latest" +fi + +if ! command -v pnpm &> /dev/null; then + error "pnpm no está instalado. Ejecuta: npm install -g pnpm" +fi + +if [ -d "$FULL_PATH" ]; then + error "El directorio $FULL_PATH ya existe" +fi + +# ============================================ +# CREAR PROYECTO +# ============================================ +info "Creando proyecto Wails: $PROJECT_NAME" + +# Crear proyecto base con Wails +wails init -n "$PROJECT_NAME" -t react-ts -d "$DEST_DIR" + +cd "$FULL_PATH" + +log "Proyecto base creado" + +# ============================================ +# CONFIGURAR GO.WORK (DevFactory) +# ============================================ +info "Configurando go.work para DevFactory..." + +if [ -d "$DEVFACTORY_PATH" ]; then + go work init + go work use . "$DEVFACTORY_PATH" + log "go.work configurado con DevFactory" +else + warn "DevFactory no encontrado en $DEVFACTORY_PATH" + warn "Configúralo manualmente con: go work use ~/.local_agentes/backend" +fi + +# ============================================ +# CONFIGURAR FRONTEND +# ============================================ +info "Configurando frontend..." + +cd frontend + +# Cambiar a pnpm +rm -f package-lock.json yarn.lock +pnpm install + +# Agregar frontend-lib si existe +if [ -d "$FRONTEND_LIB_PATH" ]; then + pnpm add "@anthropic/frontend-lib@link:$FRONTEND_LIB_PATH" + log "frontend-lib vinculado" +else + warn "Frontend_Library no encontrado en $FRONTEND_LIB_PATH" +fi + +cd .. + +# ============================================ +# ACTUALIZAR wails.json +# ============================================ +info "Actualizando wails.json..." + +cat > wails.json << EOF +{ + "\$schema": "https://wails.io/schemas/config.v2.json", + "name": "$PROJECT_NAME", + "outputfilename": "$PROJECT_NAME", + "frontend:dir": "frontend", + "frontend:install": "pnpm install", + "frontend:build": "pnpm build", + "frontend:dev:watcher": "pnpm dev", + "frontend:dev:serverUrl": "auto", + "wailsjsdir": "frontend/src/wailsjs", + "author": { + "name": "$(git config user.name 2>/dev/null || echo 'Developer')", + "email": "$(git config user.email 2>/dev/null || echo 'dev@example.com')" + }, + "info": { + "companyName": "$PROJECT_NAME", + "productName": "$PROJECT_NAME", + "productVersion": "1.0.0", + "copyright": "Copyright $(date +%Y)", + "comments": "Built with Wails" + } +} +EOF + +log "wails.json actualizado para pnpm" + +# ============================================ +# COPIAR MAKEFILE +# ============================================ +if [ -f "$TEMPLATES_PATH/Makefile" ]; then + cp "$TEMPLATES_PATH/Makefile" ./Makefile + log "Makefile copiado" +fi + +# ============================================ +# CREAR .gitignore +# ============================================ +cat > .gitignore << 'EOF' +# Build +build/bin/ +frontend/dist/ + +# Dependencies +frontend/node_modules/ + +# Go +*.exe +*.exe~ +*.dll +*.so +*.dylib +*.test +*.out +vendor/ + +# IDE +.vscode/ +.idea/ +*.swp +*.swo + +# OS +.DS_Store +Thumbs.db + +# Wails +frontend/src/wailsjs/ + +# Env +.env +.env.local +EOF + +log ".gitignore creado" + +# ============================================ +# INICIALIZAR GIT +# ============================================ +if [ ! -d ".git" ]; then + git init + git add . + git commit -m "feat: initial Wails project with DevFactory + Frontend_Library" + log "Repositorio Git inicializado" +fi + +# ============================================ +# RESUMEN +# ============================================ +echo "" +echo -e "${GREEN}═══════════════════════════════════════════════════════════════${NC}" +echo -e "${GREEN} Proyecto Wails creado exitosamente!${NC}" +echo -e "${GREEN}═══════════════════════════════════════════════════════════════${NC}" +echo "" +echo -e " ${BLUE}Directorio:${NC} $FULL_PATH" +echo "" +echo -e " ${BLUE}Comandos disponibles:${NC}" +echo -e " make dev - Desarrollo con hot reload" +echo -e " make build - Build para plataforma actual" +echo -e " make build-linux - Build para Linux" +echo -e " make build-windows - Build para Windows" +echo -e " make build-all - Build para todas las plataformas" +echo -e " make help - Ver todos los comandos" +echo "" +echo -e " ${BLUE}Próximos pasos:${NC}" +echo -e " cd $FULL_PATH" +echo -e " make dev" +echo "" + +# Verificar wails doctor +info "Ejecutando wails doctor..." +wails doctor || warn "Algunos requisitos pueden faltar. Revisa la salida anterior." diff --git a/.claude/agents/build-wails/templates/go.work.template b/.claude/agents/build-wails/templates/go.work.template new file mode 100644 index 0000000..bba79c7 --- /dev/null +++ b/.claude/agents/build-wails/templates/go.work.template @@ -0,0 +1,8 @@ +go 1.22 + +use ( + . + // DevFactory - librería Go funcional + // Descomentar y ajustar path si usas DevFactory + // ~/.local_agentes/backend +) diff --git a/.claude/agents/build-wails/templates/main.go b/.claude/agents/build-wails/templates/main.go new file mode 100644 index 0000000..b60f069 --- /dev/null +++ b/.claude/agents/build-wails/templates/main.go @@ -0,0 +1,71 @@ +package main + +import ( + "embed" + + "github.com/wailsapp/wails/v2" + "github.com/wailsapp/wails/v2/pkg/options" + "github.com/wailsapp/wails/v2/pkg/options/assetserver" + "github.com/wailsapp/wails/v2/pkg/options/linux" + "github.com/wailsapp/wails/v2/pkg/options/mac" + "github.com/wailsapp/wails/v2/pkg/options/windows" +) + +//go:embed all:frontend/dist +var assets embed.FS + +func main() { + app := NewApp() + + err := wails.Run(&options.App{ + Title: "{{APP_TITLE}}", + Width: 1280, + Height: 800, + MinWidth: 800, + MinHeight: 600, + AssetServer: &assetserver.Options{ + Assets: assets, + }, + BackgroundColour: &options.RGBA{R: 15, G: 23, B: 42, A: 1}, // slate-900 + OnStartup: app.startup, + OnShutdown: app.shutdown, + OnDomReady: app.domReady, + Bind: []interface{}{ + app, + }, + // Windows options + Windows: &windows.Options{ + WebviewIsTransparent: false, + WindowIsTranslucent: false, + DisableWindowIcon: false, + DisableFramelessWindowDecorations: false, + WebviewUserDataPath: "", + Theme: windows.SystemDefault, + }, + // Linux options + Linux: &linux.Options{ + ProgramName: "{{APP_NAME}}", + WebviewGpuPolicy: linux.WebviewGpuPolicyAlways, + WindowIsTranslucent: false, + }, + // macOS options + Mac: &mac.Options{ + TitleBar: &mac.TitleBar{ + TitlebarAppearsTransparent: true, + HideTitle: false, + HideTitleBar: false, + FullSizeContent: false, + UseToolbar: false, + HideToolbarSeparator: true, + }, + About: &mac.AboutInfo{ + Title: "{{APP_TITLE}}", + Message: "Built with Wails + React", + }, + }, + }) + + if err != nil { + println("Error:", err.Error()) + } +} diff --git a/.claude/agents/build-wails/templates/wails.json b/.claude/agents/build-wails/templates/wails.json new file mode 100644 index 0000000..4ce0123 --- /dev/null +++ b/.claude/agents/build-wails/templates/wails.json @@ -0,0 +1,22 @@ +{ + "$schema": "https://wails.io/schemas/config.v2.json", + "name": "{{APP_NAME}}", + "outputfilename": "{{APP_NAME}}", + "frontend:dir": "frontend", + "frontend:install": "pnpm install", + "frontend:build": "pnpm build", + "frontend:dev:watcher": "pnpm dev", + "frontend:dev:serverUrl": "auto", + "wailsjsdir": "frontend/src/wailsjs", + "author": { + "name": "{{AUTHOR_NAME}}", + "email": "{{AUTHOR_EMAIL}}" + }, + "info": { + "companyName": "{{COMPANY_NAME}}", + "productName": "{{PRODUCT_NAME}}", + "productVersion": "1.0.0", + "copyright": "Copyright {{YEAR}}", + "comments": "Built with Wails" + } +}