History

Liqiang Lau 08f305d712 feat: add IsLark field to FeishuConfig to switch between Feishu and Lark domains (#1753 ) * feat(feishu): add Lark (international) support via IsLark config field Add IsLark field to FeishuConfig to switch between Feishu and Lark domains. Also fix domain inconsistency where WS client defaulted to LarkBaseUrl while HTTP client used FeishuBaseUrl. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: update documentation and web UI for Lark support Add is_lark field to config example, feishu docs, i18n translations, and web frontend form. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>		2026-03-19 00:29:55 +08:00
..
backend	refactor: centralize environment variable key constants (#1730 )	2026-03-18 18:03:24 +08:00
frontend	feat: add IsLark field to FeishuConfig to switch between Feishu and Lark domains (#1753 )	2026-03-19 00:29:55 +08:00
Makefile	fix for feat(web): implement macOS app feature and file logger (#1735 )	2026-03-18 18:00:14 +08:00
picoclaw-launcher.desktop	feat(web): migrate launcher to modular web frontend/backend and improve management UX (#1275 )	2026-03-09 19:42:03 +08:00
picoclaw-launcher.png	feat(web): migrate launcher to modular web frontend/backend and improve management UX (#1275 )	2026-03-09 19:42:03 +08:00
README.md	feat(web): migrate launcher to modular web frontend/backend and improve management UX (#1275 )	2026-03-09 19:42:03 +08:00

README.md

Picoclaw Web

This directory contains the standalone web service for picoclaw. It provides a complete unified web interface, acting as a dashboard, configuration center, and interactive console (channel client) for the core picoclaw engine.

Architecture

The service is structured as a monorepo containing both the backend and frontend code to ensure high cohesion and simplify deployment.

backend/: The Go-based web server. It provides RESTful APIs, manages WebSocket connections for chat, and handles the lifecycle of the picoclaw process. It eventually embeds the compiled frontend assets into a single executable.
frontend/: The Vite + React + TanStack Router single-page application (SPA). It provides the interactive user interface.

Getting Started

Prerequisites

Go 1.25+
Node.js 20+ with pnpm

Development

Run both the frontend dev server and the Go backend simultaneously:

make dev

Or run them separately:

make dev-frontend   # Vite dev server
make dev-backend    # Go backend

Build

Build the frontend and embed it into a single Go binary:

make build

The output binary is backend/picoclaw-web.

Other Commands

make test    # Run backend tests and frontend lint
make lint    # Run go vet and prettier/eslint
make clean   # Remove all build artifacts